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From the Editor 



Every OS you need 
on a single PC! 


Finally it's possible! Win95, NT, 
OS/2, Warp, MS-DOS, PC-DOS, 
Novell-DOS, SCO Unix, NetWare, 
UnixWare, Solaris, Linux, Coherent 
or any other Intel compatible OS can 
reside on one machine with many 
other operating systems. 

Now you can have up to 16 ver¬ 
sions of DOS and 26 other Intel 



compatible operating systems on 
one PC! System Commander dis¬ 
plays a menu at boot up before any 
OS runs. Pick the OS you want and 
you' re up and running. Want another 
OS? Simply reboot and make an¬ 
other selection from the menu. 

System Commander is a necessity 
for multi-platform developers, beta 





"Highly recommended." 
John C. Dvorak 
PC MAGAZINE 


testers, tech support managers, QA 
testers, and software evaluators. 

System Commander is only $99.95 
and comes with a 60 day money- 
back, guarantee. And, for a limited 
time, get FREE overnight shipping 
when you mention this ad* . 

Call now! 
1 - 800 - 648-8266 

60-DAY MONEY-BACK GUARANTEE 


V Communications, Inc 

4320 Stevens Creek Blvd., Suite 120-WD 
San Jose, CA95129 408-296-4224 
FAX 408-296-4441 
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At Software Development 95, Microsoft had a big sign labeled "Ask the Developer, 
and you could walk up and ask product questions of someone who had actually helped 
develop the product. It dawned on me that Microsoft was missing a major money-mak¬ 
ing opportunity. All they had to do was buy a bunch of Nerf bats, charge $5 per person, 
and change the name to "Whack the Developer." What Windows developer would not 
pay $5 to whack the designer of GDI, or the author of DDEML? Most programmers 1 
talked to agreed that Microsoft could make a(nother) fortune this way, but C/C++UJ Man¬ 
aging Editor Marc Briand cautioned, "I think that could get out of hand pretty quick." 

I thought it was a mistake in the press release when I read that the new version of 
Vireo's VtoolsD (a toolkit for writing VxDS in C and C++) can replace the DDK. Microsoft 
does not provide support for device driver writers, and they keep the DDK expensive 
partly by forcing reliance on proprietary tools (most notably, the linker) that Microsoft re¬ 
fuses to license or document, it's no mistake, though - the folks at Vireo have come up 
with their own replacement linking technique, and you can build a VxD with their tool 
(works with both Borland and Microsoft C++ compilers) without also having to buy the 
DDK. Of course, you may still need to buy the DDK just to get more precious shreds of 
information on writing drivers, but many developers may prefer to spend their money 
on a supported product from a small company, than on an unsupported product from a 
very large company. 

This month, Mark Nelson contributes an article to the precompiled header debate. I 
verified that his instructions produced faster compiles for me from all four compilers l 
use: Borland, Microsoft, Watcom, and Symantec. Even though each compiler implements 
precompiled headers slightly differently, Mark shows how to set up your project so it can 
best take advantage of precompiled headers no matter which compiler you use. 

We've got so many email addresses now, I think we may need to add a little address 
book to our Table of Contents page. Use wdletter@rdpub.com to send a letter to the 
editor or submit a compiler bug to the Bug++ of the Month column. Use 
paul@rdpub.com to submit a question to our 'Windows Questions and Answers' col¬ 
umn. If you have an idea for a Tech Tip (it pays a minimum of $75), send it to 
Ieor@bdsoft.com. If you have an SDK Annotation (gets you a free T-shirt) or an article 
idea, send it directly to me at 70302.2566@compuserve.com. If you need to renew, sub¬ 
scribe, replace a missing or damaged issue, change your address, or handle most any 
subscription-related task, send mail to wdsub@rdpub.com. The R&D book department 
can get you any book that appears in 'Books in Brief," and they can be reached at 
rdorders@rdpub.com. You can use email to get more information on products adver¬ 
tised here by sending the reader service number, the volume and issue number (this 
month is 06.04), and your physical mailing address to wdrs@rdpub.com. 

The quote of the month comes from Rick Segal, Microsoft's Manager of Developer 
Relations. He bravely posted on CompuServe's DDJFORUM a press release regarding Mi¬ 
crosoft's intention to defend any developer whom Apple might sue in the current Video 
for Windows brouhaha. However, Rick prefaced the official statement with an off-the- 
cuff summary that included the sentence 'We care about every developer that uses 
Microsoft Product." Truly, the age of the kindler and gentler Microsoft is upon us. 


Ron Burk 

Editor 

CIS: 70302,2566', Internet: ronb@rdpub.com (“... tuunettrdpubtronb") 
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Communications 



Writing Mail-Enabled 
Applications with MHS 

Lee Wiltbank 


Novell NetWare versions 3.12 and 4.1 include a copy of Basic MHS (Mes¬ 
sage Handling System), NetWare's native messaging system, as well as a copy 
of FirstMail, a stripped-down version of Pegasus Mail by David Harris. FirstMail 
is an SMF-71-compliant mail program with DOS and Macintosh executables. 
While you can use FirstMail straight out of the box for simple messaging, with 
a little work and time, you can create customized MHS applications to help you 
be more productive. In this article, I will discuss some of the concepts of MHS 
and describe an implementation of NOTIFY, a Visual Basic application to notify 
users of new messages. 

At the company I work for, we run two NetWare 3.12 servers, SONNY and 
CHER. SONNY handles the backup, WAN, and NetWare Connect for the com¬ 
pany, while CHER is our development server. Because the company is still quite 
small, we didn't at first feel the need for e-mail, since you could simply yell 
your message across the hall to other developers. But as we grew, and espe¬ 
cially as our secretaries moved upstairs, we decided it was time to get an e- 
mail package. Because NetWare 3.12 contains Basic MHS and FirstMail, we 
began using it, then downloaded the full Pegasus Mail package. We found that 
most of our users were not happy with this system: we are primarily Windows 
developers and we weren't able to find a small Windows executable that could 
notify us when a new message had arrived. So, another developer and I wrote 
NOTIFY, an application that could be put in everyone's Startup group and that 
would present a small window on the desktop showing the number of new 
messages. We wrote the first program in C, but since I wanted to concentrate 
more on the concepts of MHS, for this article I have rewritten NOTIFY with 
Visual Basic. 

MHS 

MHS is Novell's native messaging system. When you install MHS on a serv¬ 
er, it creates the messaging directory structure shown in Figure 1. To send a 
message, the application first creates the message in the proper format, then 
writes it into the ... \mhs\mail\snd subdirectory. Attachments to the message are 
written into the ...\mhs\mail\parcel subdirectory. The Message Transfer Agent 
(MTA) on the server, written as a NetWare Loadable Module (NLM), periodically 
checks the snd directory for new messages, by default every 45 seconds. 


Lee Wiltbank is the consulting editor for Network Administrator, a magazine for PC 
network administrators. He can be reached on CompuServe at 71776,1274. 
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Build multi-megabyte DOS programs 
easily, in 16 or 32 bits. 

Here are two great solutions to your DOS 

memory crunch: TNT DOS-Extender® 

for up to 4 gigabytes in 32 bits, and 

286lDOS-Extender™ for as much as 16 

megabytes in 16 bits. Finally your programs 

can access all the memory in a PC. 

Choose TNT DOS-Extender if you want 
ultimate 32-bit power and speed. The flat 
memory model also makes it simple to port 
from UNIX. Or, to boost memory in your 
16-bit application, use 286IDOS-Extender. 
Either way, you get the most trusted, most 
widely-used DOS-Extenders in the world. 



Favorite tools. 

All Phar Lap DOS-Extenders work with 
Microsoft and Borland C/C++ compilers. 
For 32-bit development, you can also 
choose MetaWare, Symantec, or Watcom. 
Keep using CodeView or Turbo Debugger, 
and all your run-time libraries, including 
graphics. Nobody else gives you this 
flexibility. 

performance. 

The TNT DOS-Extender turns 
DOS into a true 32-bit operating 
system with a flat, 32-bit address 
space. You’ll build smaller, faster pro¬ 
grams, and dramatically improve the per¬ 
formance of math-intensive applications. 

Get advanced features like multitasking, 
DLLs, and threads. 

Compatibility. 

Because you embed a Phar Lap DOS- 
Extender into your program, there’s nothing 
special for end-users to type at the DOS 


Enhances 



prompt. All they see is the power they 
never got under conventional DOS. And 
because Phar Lap products support the 
XMS, VCP1, and DPMI industry standards, 
your applications run under DOS, Windows 
(3-1 and NT), OS/2, and even Windows 95. 



Adds Windows GUI, too. 

| With the TNT DOS-Extender, you 
can turn a DOS application into a 
| Windows application. Our exclu¬ 
sive WinPipe technology lets you retrofit 
existing DOS applications with a Windows 
front-end. And, unlike Windows programs, 
your applications will run wherever you 
want them — under Windows and DOS. 


Fully proven. 

Phar Lap DOS-Extenders are the leading 
DOS memory solution, in use in thousands 
of products including Visual C++ by 
Microsoft and AutoCAD by Autodesk. Call 
today and find out how you can push the 
limits of your applications with Phar Lap 
DOS-Extenders. 


>£~Phar Lap Software, Inc. 


60 Aberdeen Avenue, Cambridge, MA 02138 617-661-1510 FAX: 617-876-2972 


Phar Lap and TNT DOS-Extender are registered trademarks, and 286IDOS-Extender is a trademark of Phar Lap Software, Inc. 
All other product and company names are trademarks or registered trademarks of their respective holders. 
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Figure 1 MHS messaging directory structure 



When the MTA sees a message, it parses the message for 
the destination user. If the user resides on the same serv¬ 
er, the MTA copies the file into the ...\mhs\mail\us- 


ers\username\appname subdirectory and any attachments 
into the ...\mhs\mail\users\usernanie\iparcel subdirectory. If 
the user resides on another server, the MTA copies the 
message into the ...\mhs\mail\queues subdirectory for re¬ 
mote delivery. In the figure, the user directory represents 
the user's login name, and the appl subdirectory repre¬ 
sents the application directory. With FirstMaii, for example, 
my username would be lwiltban and the application 
would be first. A user can have up to five applications 
defined, with the first application being the preferred one. I 
will explain how to find the user's logn name and preferred 
application later in the article. 

While MHS uses a well-known directory structure for 
sending and receiving messages, the format of the mes¬ 
sages gives MHS a flexible architecture. MHS formats mes¬ 
sages according to the Standard Message Format (SMF). 
(There are two versions of SMF currently in use, the older 
SMF-70, and the newer SMF-71; unless otherwise noted, 
the format discussed here will be SMF-71.) An SMF mes¬ 
sage consists of three parts: the envelope, the message 
heading, and the message body. Both the envelope and 
the message heading are composed of keyword-value 
pairs. The first line of the message consists of the SMF 
signature, 'SMF-71.' The envelope tells the MTA how to 
process and deliver the message. SMF applications use the 
message heading to pass information to the receiving ap¬ 
plication. After the envelope and message heading, a 
terminator signifies the last of the header information. 
The terminator is one or more <LF>s or <CRXLF>s. 


Translate 
your old 
PASCAL or 
BASIC code 
into readable 
and maintainable 
C at up to 3000 
41 lines per minute. 



Vax Pascal C 

Turbo Pascal C 

Microsoft Pascal C 
Microsoft GW-Basic C 

Microsoft Quick Basic C 

Microsoft Professional Basic C 
Turbo Pascal with Objects C++ 
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TX Text-Control 
DLL brings 
true WYSIWYG 
Text Processing 
to your WINDOWS 
Application 

Features 

Multiple fonts • Paragraph formatting • Zooming ■ Macrofields 
Optional integration of images in various formats • Low cost 
version available for Visual Basic 

GET YOUR FREE DEMO TODAY! 

Call 913 832 2070 (North and South America) 

European Software Connection, RO. Box 1982 
Lawrence, Kansas 66044, USA 
Fax: 913 832 8787, CompuServe: 71141,3624 

Elsewhere contact 

DBS GmbH, Kohlhokerstrasse 61,28203 Bremen 
Germany, Phone: +49 421 33 591-0 
Fax: +49 421 339 8658, CompuServe 100013,115 
Or download TXDEMO.ZIP from CompuServe 
(Forum WINSDK, section PUBLIC UTILITIES) 


D Request Reader Service #274 □ 

April 1995 















































Figure 2 SMF envelope fields 

Field 

Description 

Addresses-referred-to 

Addresses associated with notification 

Attachment 

Attachment files 

Attachment-date 

Dates for the attachments 

Attachment-encoding 

Character set used for encoding 

Attachment-name 

Original name of attachments 

Attachment-type 

Format for attachments 

Date-delivered 

Date delivered to receiver 

Date-posted 

Date MTA received the message 

Date-transferred 

Date sender transferred message to receiver 

Delivered-to 

Recipient of message 

Destination-application 

Destination application name 

DL-expansion 

Distribution list 

Error-report 

SMF error code 

Expiration-date 

Date ater message is obsoleted 

Exported-to 

Detailed information about recipient 

Header-encoding 

Character set used to encode free-form fields 

Hop-count 

Number of MTAs a message has gone through 

MCB-options 

Message-delivery options 

MCB-type 

Type of MCB message 

Message-encoding 

Character set used to encode message body 

MHS-id 

16-byte id number assigned by MTA 

Notification-correlator 

String used to match notifications and messages 

OEMappname-proprietary_keyword 

Proprietary keyword 

Received-by 

Recipient who displayed or processed message 

Refused-by 

Recipient who received but didn’t process message 

Rejected-for 

Rejection explanation 

Sent-to 

Intended recipients 

Sender 

Sender and recipient of notifications 

Session-id 

Session id for internal use of NTA 

Signature 

First line of message, SMF-71 

SMF-version 

SMF version of MTA that picked up the message 

Via-host 

Server and workgroup where message was composed 

X-Any_text_string 

Experimental 


Figure 3 SMF message heading fields 

Field 

Description 

Application-name 

Originator’s application name 

Authors 

Names of the authors 

BCC 

Address of blind copy recipients 

Comments 

Comments 

Conversation-id 

Unique id for conversation 

Copies-to 

List of each recipient's address 

Date 

Date message was composed 

Date-received 

Date recipient's application receives the message 

Form-type 

Type of form in message body 

From 

Sender’s address 

Importance 

Priority of message 

In-reply-to 

Message ID of original message 

Keywords 

List of keywords used to classify a message 

Message-id 

Unique message id 

Message-type 

Content type of message body 

OEMappname-proprietary_keyword 

Proprietary keyword 

Original-copies-to 

Original Copies-to header before expansion 

Original-to 

Original To header before expansion 

Originator 

Original of first message in a string of messages 

Reply-copies-to 

Address of recipients who should receive copies 

Reply-to 

Address of recipient who should receive reply 

Re-sent-by 

Identifies the person or MTA that re-sent 

Respond-by 

Date the recipient is to respond 

Ret-message 

Unique identification number of notification 

Sensitivity 

Confidentiality level of message 

Subject 

Message subject line 

Summary 

Summary of contents 

To 

Address of primary recipients 

X-Any_text_string 

Experimental 



tion. Those who have tried other products 
have been disappointed with the dismal re¬ 
sults. 

Clearly, a new standard of excellence! 

Sourcer solves these problems with ad¬ 
vanced analysis and simulation. The quality 
of output is so good that most DOS EXE & 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 

To make the results easier to understand 
Sourcer provides detailed and descriptive 
comments for interrupt subfunctions, I/O 
ports and much more. Sourcer even lets you 
examine encrypted and packed programs. 

mov ax,2517h 
mov dx,offset int_17h_entry 
int 21 h 

mov dx,offset data_4 
mov ah ,9 
int 21 h 

mov dx,19h 
mov ah,31h 
int 

virustst endp 


int_17h_entry proc far 

pushf ; Push flags 

Partial Disassembly of a Virus 

C/C++ and Pascal 

Some C, C++ and Pascal developers hate 
disassembly because the source code they get is 
assembly. We can't change that, but we can 
make it easier for you by automatically identi¬ 
fying the use of parameter passing and local 
stack variables. Parameters pushed onto the 
stack prior to a subroutine call are clearly com¬ 
mented. 

Get commented BIOS listings 

The BIOS Pre-Processor creates commented 
listings for any BIOS ROM. Understand how 
your specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Inserts labels 
like "int_10_video". And it's fully automatic. 

Windows disassembly! 

Windows Source generates detailed listings 
of Windows EXEs, DLLs, VxDs, device 
drivers, & OS/2 NE files. Windows Source 
labels, by name, export & import function calls, 
API calls like "GetModuleHandle”, undocu¬ 
mented APIs, VxD functionsand much more. 

Call now! 
1 - 800 - 648-8266 


Sourcer $149.95 

Sourcer & BIOS Pre-processor 189.95 

Sourcer & Windows Source 249.95 

Sourcer, BIOS & Windows Source 289.95 

Shipping: USA $6; Canada/Mexico $10; All others $25. 

CA residents add sales tax. © 1994 VISA/MC/Amex/COD 

30-DAY MONEY-BACK GUARANTEE 
V Communications, Inc. 

4320 Stevens Creek Blvd., Suite 1 20-WD 
San Jose, CA 95129 408-296-4224 
FAX 408-296-4441 



, \ j\jo oeiviuea dii=iuiiwiuii mii 

: set intrpt vector al to ds:dx 
; ('Halt when ? printed.') 

: DOS Services ah=function 09h 
; display char string at ds.dx 


DOS Services ah=function 31 h 
terminate and stay resident 
al=return code,dx=paragraphs 
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Figure 4 Person-to-person in minimal submission 
format 


SMF-71 

From: Lee WiltbankSSynergetics 
To: Lee Wi1tbank@Synergetics 
Subject: Message Submision 

MHS Test 
Lee Wiltbank 
Synergetics 


Figure 5 Canonicalized SMF message 


SMF-71 

242Send-to: Lee Wiltbank@Synergetics 

21Date-delivered: 31-Jan-1995 16:14:14 -0500 ; at Synergetics 

2300Sender: Lee Wiltbank@Synergetics 

2000MCB-options: NNYNANAYA 

2200MCB-type: 0 

2100Date-posted: 31-Jan-1995 16:14:14 -0500 ; at Synergetics 

2200SMF-version: 71 

2200Error-report: 0 

2000MHS-id: 25612E2F813F0000 

From: Lee Wiltbank@Synergetics 

To: Lee WiltbankSSynergetics 

Subject: Message Submision 

Message-id: 27612E2F813F0000 

Via-host: Synerget.Synerget 

Date: 31-Jan-1995 16:14:14 -0500 

MHS Test 
Lee Wiltbank 
Synergetics 


The message body consists of either tree-form text or 
structured text, depending on the application in which it 
was created. 

Figure 2 lists the SMF envelope fields; Figure 3, the 
message heading fields. Though SMF defines many fields 
for the envelope and message heading sections, only a 
few of these are required. Figure 4 shows a person-to-per- 
son message that I created with the DOS Editor: the message 
contains the Signature header, the messaging headers 


Figure 6 Canonical message SMF fields 


SMF-71 

Sender 

Send-to 

MCB-options 

MCB-type 

Hop-count 

Date-posted 

Error-report 

SMF-version 

Attachment (Only if the message has an attachment) 

MHS-id 

Subject 

Date 

Message-id 

Via-host (For backward compatibility) 


FIND YOUR BUGS BEFORE THEY FIND YOU. 


Make project development a 
whole lot easier by picking up a 
copy of MemCheck®. 

MemCheck pinpoints serious C/ 

C++ bugs that other debuggers don't, 
and goes where other debuggers can't. 
You'll find MemCheck's automatic 
bug-spotting absolutely invaluable for 
completing rock-solid projects. 


other debuggers, you'll get 

windows double and triple value as 

version!! MemCheck scouts silently for 

problems in your apps on testers' 
machines or at client sites! It does 
all this automatically. You can even 
use it to debug multiple applications and 
DLL's at the same time, along with your 
favorite conventional debugger. 


“MamChutk It the mott valuable laal I use" 

— Ashwin Nirmul/ANSTAT Software 


Resource Roundup 

The new MemCheck V3.0 for 
Windows watches over all kinds of 
things for you, including bitmaps, 
brushes, carets, cursors, DC's, icons, 
menus, pens, memory blocks, timers, 
windows, and more. You'll be notified 
by the exact file and line of errors 
involving over one hundred of the most 
important Windows API calls. 




Debugging Power 
on Tap 

You can use MemCheck 
continuously during 
development — no spot 
checks here. Unlike 


Seamless Integration 

MemCheck integrates smoothly into your 
C or C++ projects, and you won't have to 
change a line of code you've written. 
Using MemCheck brings big payoffs in 
time savings for expert and novice 
alike. Call 1 - 800 - 933-3284 (1-800- 
WE-DEBUG) today to make your software 
apps the best they can be. International 
callers, call +1-313-996-2944. 
Unconditional 30-day money back 
guarantee on all ordersI 



THIS 

DOS Developer’s Special 


Get MemCheck for DOS, C-Heap Standard and 

MONTH * S 

The Heap Analyst. A $290 value, SAVE $90! 

SMCIAI 

► 

Specify Borland or Microsoft. 

only $199 



NSW! MEMCHECK V3.0 FOB WINDOWS ...... $ 139 

Upgrade from V2.1 - $59. Specify Microsoft C/C++ * 

8.x, VC++) or Borland C/C++ (3.x, 4.x) only 

MEMCHECK V3.0 PROFESSIONAL FOR DOS.^gl39 

Specify Microsoft C/C++ (6.x-8.x, VC++J, Borland C/C++ 

(BC++ 2.x-4.x), or Watcom C/C++ (9.5) only 

MEMCHECK V2.1 FOR ANSI/KAR ... $199 

For any UNIX, VAX, or any ANSI C or K & R projects. 

Includes full source code! An unbeatable value! 

with DEVELOPER BUNDLES! 1 

DOS MASTED PACK .. SI**. - 

for Microsoft C and Borland C — save $80 ! 

WINDOWS GURU PACK .. 

for Microsoft C and Borland C — save $80 ! 

MICROSOFT POWER PACK _ $19f 

for Microsoft C/C++ under DOS and Windows 

BORLAND POWER PACK . pjjj^L. 

for Borland C/C++ under DOS and Windows 


CALL 


1 - 800 - 


WE USE AND SHIP QUALITY RECYCLED MATERIALS. 


StrtltOsWare Corporation I 56 R/yinonrb Road Suite 1500 • Aim Ar/rn . Ml t8105 • 1 -800-WE-DEBUG • International (M.i) 996-2 l M • 
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THE OFFER: FREE Windows NT 
& Windows 95 Install Software 


Install95: A Complete Setup Program 
With Full Source Code (A $395 Value) 

■ Written in Visual C++ 2.0 and Korn Shell 

■ Handles new Windows NT & 95 features: 

Registry Entries, Program Groups, 

Services, Environment Variables, 

Directories, Files, Security Attributes 

■ All your software installation specs are 
maintained in a simple text file. 

■ Runs on Intel, MIPS and Alpha systems. 

■ Includes a comprehensive diskette and 
CD-ROM layout utility. 

■ No runtime royalties. 

THE CATCH: To Modify Install95, You Need 

Portage UNIX For Windows NT 

Based On Licensed 
UNIX svm,2 Source 

Licensed directly from 
AT&T, USL and Novell. 

Fully integrates UNIX 
* With Windows NT 

We've implemented the 
UNIX kernel as a DLL using 
the Win32 API, including 
hard links, symbolic links, 
UNIX file permissions, case- 
sensitive long file names, 
and much more. Integrated 
properly with Windows NT. 

Dialog Box 
'* Interface For Every 
UNIX Command 


Over 140 Standard 
UNIX Commands 
Including at, awk, cpio, 
cron, find, grep, mail, ps, 
tar and vi. 

Portage SDK Has * 
30 More Commands 

Including ar, cc, Id, 
make and SCCS, plus 
the standard UNIX 
subroutine libraries. 

Both ksh and csh 
are Provided 


UNIX Man Pa 
As Windows 


8 


es 

elp 




Sample screens from Portage product 
installation, written entirely with Install95. 


THE DEAL: Order Portage UNIX For Windows NT Now 
For Only $395, And Get Install95 Source Code Free 



Portage Prices 


Portage Base System $395 

Portage Base + SDK $695 

Portage Base + X Server $695 

Portage Base + X Server $995 


+ SDK + XDK (Xlib & Motif) 

(Add $100 for all MIPS and Alpha Versions) 


Portage makes it much easier to do software 

development, product testing and system administration tasks on 
Windows NT. We wrote Install95 out of absolute frustration with 
the difficulty of using Microsoft's setup program and the leading 
commercial install programs, and both our developers and our 
customers are glad we did. Install95 is a perfect example of the 
value of UNIX tools in a Windows environment— and for a 
limited time it's yours free with any Portage order. 


The Portage Base System, with over 140 standard UNIX utilities, is 
Consensys Corp Tel: 1-800-388-1896 only $395 for Intel systems. You can save $100 by ordering the 

om 0k xv Rd - 1 -905-940-2900 Base and the SDK together for $695. If you also want the Portage 

Universal City, TX p _ , rM<~v QQn , 3 x Server, the Portage X& Motif Development Kit, the Portage 

78148 r 3X. 1-yUtD-yT-U-^yUvJ Network Development Kit (with full UNIX sockets library), or 

Trademarks/Owners: CONSENSYS, Portage, Install95l Consensys Corp.; Portage NFS (client and server), call for information about special 

Windows NT, Windows 95/Microsoft Corp.; Alpha AXP/DEC; MIPS/Silicon 

Graphics, Inc.; UNIX/X/Open, Inc.; Motif/Open Software Foundation Dunaiea pricing. 
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Figure 7 Person-to-person message with 
attachments 


SMF-71 

From: Lee Wiltbank@Synergetics 
To: Lee Wi1tbank@Synergetics 
Attachment: 10101010 
Attachment-name: attachment.doc 
Attachment-type: Microsoft Word (5.1) 
Subject: Message Submision 

MHS Test 
Lee Wiltbank 
Synergetics 


(From: and To:), the terminator, and then the message 
body. Copying this file to the ... \mhs\mail\snd directory di¬ 
rects the MTA to deliver the message to me. The MTA 
parses the message and fully expands it into a canonical 
format for delivery, as shown in Figure 5. Figure 6 lists the 
fields that the MTA generates in the canonicalized mes¬ 
sage. Figure 7 is an example of a message with attach¬ 
ments. To send attachments, an application copies the at¬ 
tachment files to the ...\mhs\mail[parcel directory and 
gives each file a unique name. The unique name is 
shown in the Attachment field; the original name of the 


Listing 1 global.bas — containing declarations for functions in nwcalls.dll; user-defined types; constants; global 
variables; and various functions 


Option Explicit 
Option Base 1 

’Win SDK calls and Consts 
Global Const ATTRJORMAL = 0 

Global Const NAMESIZE = 9 

Global Const PWSIZE = 10 

Global Const OSCRSIZE = 25 

Global Const SERLEN = 15 

Global Const ENTRYSIZE = 128 

Global Const FILLSIZE = 37 

Global Const NETDIR_RECORD$IZE = 128 

Global Const NAMEAPPS = 5 

’User-defined types 


Type HdrEntry 

e_etype As String * 1 
s_conz As String * 1 
s_hname As String * NAMESIZE 

s_hpass As String * PWSIZE 

s_hfull As String * DSCRSIZE 

s_admin As String * NAMESIZE 

s_print As String * NAMESIZE 

s_modem As String * NAMESIZE 

s_sport As String * 2 

s_notinw As String * 1 
s_entprs As String * NAMESIZE 
$_padl As String * 3 
s_htype As String * 1 

s_prhub As String * NAMESIZE 

s_baud As String * 2 


s_serial As String * SERLEN 
s_niocal As String * 2 
s_version As String * 1 
s_netw As String * NAMESIZE 
s_nopthr As String * 1 
End Type 

Type NameEntry 

e_etype As String * 1 
e_name As String * NAMESIZE 
n_ful1 name As String * DSCRSIZE 
n_password As String * PWSIZE 
n_netident As String * 1 
n_apps(5) As String * NAMESIZE 
n_fill As String * FILLSIZE 
End Type 


With color reduction 


Image Processing Library 

Create Fowerful Image Applications 

for FMF, TIFF, FCX, GIF, TGA, and JFEG Images 


for fast, accurate 
24-bit image display 



P 

P 

► 

► 


Load and save 

BMP/TIFF/PCX/GIF/TGA/JPEG 

Powerful grayscale and color 
image processing: brightness, 
contrast, sharpen, outline, 
equalize, matrix convolution, 
rotate, resize, and more 

Color reduction for fast and 
accurate display of 24-bit images 

Support for EGA/VGA/SVGA, 32K- 
and 16 million-color displays 


!► Scan b/w, grayscale, and color 
images with ScanJet scanners 


jjfr Print halftones, diffusion scatters, 
and color pictures 

(► Convert images between 1-, 8-, 
and 24-bit formats 

P Convert color to grayscale 

pt- Includes a complete image 
’ processing application with C 
source 


Catenary 



Your Windows application can load and 
save BMF TIFF. FCX. GIF. TGA. and JFEG 
files, control scanner and printer, and have 
powerful Image processing and color 
reduction for the very best Image display. 


Victor Image Processing Library 
for Windows (DLL), $295 

Victor Image Processing Library 
for DOS, supports Microsoft 
and Borland C/C++ compilers, $195 

Call or fax to order 

314-962-7833 

Systems 


470 Belleview St Louis MO 63119 

314-962-7833 


Victor Image Processing Library for Windows or for DOS. No royalties. Source code available, visa/mc/eod. 
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Copy Protection; 


Order your 
evaluation 


We are 
looking for 
international 
distributors 


package 

today! 


✓ New: Now for Apple Macintosh and PowerPC 

✓ Tools for Apple Macintosh User and Developer 

✓ Also available for LPT, COM, (E)ISA slots and PCMCIA 

✓ Protection for DOS, Windows and networks without 
requiring source code modification 


✓ Also for Win32s™, Windows NT™, OS/2® and DOS 

'-^WIBU-KEYy* 

High Quality in Copy Protection 


UIBU 

SYSTEM S 


WIBU-SYSTEMS GmbH 
Rueppurrer Strasse 54 
D-76137 Karlsruhe, Germany 
Phone:+49-721-93172-0 
FAX: +49-721-93172-22 


Southwind International Inc. 
P. O. Box 308 

Brookeville, MD20833, USA 
Phone: (301) 570-3497 
FAX: (301)570-4773 
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THE TRIP TO CLIENT/SERVER CAN BE HAZARDOUS, 
UNLESS YOU NAVIGATE YOUR WAY WITH BTRIEVE 6. 


Everyone knows the dangers 
in moving to client/server What 
you may not know is that 
Btrieve 6 provides a safe, direct 
route to client/server with total 
control over relational structures 
and distributed data routines. 

So you can chart the fastest path 
to your data. And you can add 
SQL applications at any time. 

INTRODUCING NAVIGATIONAL 
CLIENT/SERVER. 

While SQL provides great flexi¬ 
bility, it can limit your control 
and performance. Navigational 
client/server allows you to cus¬ 
tom design relational structures 
and maximize performance 
with directional controls to 
retrieve, update, insert and 
delete distributed data. 


With Btrieve 6, you’ll have 
the transaction processing mus¬ 
cle to build multi-gigabyte data¬ 
base servers supporting hun¬ 
dreds of users with sub-second 
response times. And Btrieve 6 
supports the major server plat¬ 
forms, NetWare, Windows NT, 
and OS/2 LAN Server and the 
major client platforms. 

FLY PAST RETRAINING 
PROBLEMS. 

Btrieve 6 directional controls 
integrate with existing applica¬ 
tion code so you can selectively 
upgrade your current applica¬ 
tions to client/server Using your 
3, 4 and 5GL tools, merely 
replace your data management 
code with Btrieve 6 and couple 
it with the application code. 


This way your end-users will be 
working with familiar applica¬ 
tions. You’ll avoid the need for 
the massive retraining that 
accompanies a sweeping change 
to new applications, an effort 
that takes from 40 to 50 per¬ 
cent of most conversion budgets 
(Source: The Gartner Group). 



PICK UP SQL ALONG THE WAY. 


Btrieve 6 integrates with Scalable 
SQL,~ our award-winning rela¬ 
tional database. Since both are 
built on our new MicroKernel 
Database Engine!" SQL applica¬ 
tions work in unison with Btrieve 
applications-each having con¬ 
current access to all data. 

Now you have the freedom 
to write new applications in 
Btrieve or SQL, and the trip to 
client/server will be much more 
manageable. So navigate your 
way with Btrieve 6. 


IT SIMPLY WORKS 

1 BTRIEVE 

WH TECHNOLOGIES 


To receive a free white paper, call 
800-BTRIEVE or (512) 794-1719, 
CompuServe (CO BTRIEVE). 
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The NOTIFY Application 

attachment appears in the Attachment-name field; and the Our company needed a small Windows application that 
type is in the Attachment-type field. could scan the user's mail directory and notify the user of 


Listing 1 continued 


Type ApplEntry 

Global gSubjectText As String 

Global gFromText As String 

Global gDateText As String 

e_etype As String * 1 
e name As String * NAMESIZE 

’NWCALLS.DLL function prototypes 

a fullname As String * DSCRSIZE 

Declare Function NWGetFileServerName Lib "NWCALLS.DLL" 

a_password As String * PWSIZE 

(ByVal conn As Integer, ByVal serverName As String) As Integer 

a qtyusers As String * 2 

Declare Function NWGetConnectionHandle Lib "NWCALLS.DLL" 

a maxusers As String * 2 

(ByVal serverName As String, ByVal reserverl As Integer, 

a vercntrl As String * 1 

conn As Integer, reserved2 As Any) As Integer 

a mgmtcntrl As String * 1 

Declare Function NWGetDefaultConnectionID Lib "NWCALLS.DLL" 

a fill As String * 77 

(conn As Integer) As Integer 

End Type 

Declare Function NWCallsInit Lib "NWCALLS.DLL" 

Type USER INFO 

(ByVal in&, ByVal out&) As Integer 

Declare Function NWGetFi1eServerlnformation Lib "NWCALLS.DLL" 

connNumber As Integer 

(ByVal conn As Integer, serverName As Any, majVer As Any, 

objectName As String * 48 

minVer As Any, rev As Any, maxConn As Any, maxConnUsed As Any, 

objectType As Integer 

maxConnsInuse As Any, numVol As Any, sft As Any, tts As Any) 

objectID As Long 

As Integer 

ToginTime As String * 7 

Declare Function NWGetConnectionlnformation Lib "NWCALLS.DLL” 

End Type 

(ByVal conn As Integer, ByVal connNumber As Integer, 

’Global variables used with NOTIFY 

objectName As Any, objectType As Any, objectID As Any, 
loginTime As Any) As Integer 

Global serverPath As String 

Declare Function NWGetConnectionNumber Lib "NWCALLS.DLL" 

Global MHSOirectory As String 

(ByVal conn As Integer, connNumber As Integer) As Integer 

Global userApplication As String 

Global gScanNext As Integer 

Sub DisplaySubjects 0 


“One line of code... 
One click...” 



INTEGRATE DIGITAL AND OVERLAY VIDEO, ANIMATION, AUDIO 
AND GRAPHICS IN YOUR WINDOWS APPLICATIONS 


OLE 2.0 automation server 


Visual Basic VBX, OCX 
C and C++ libraries 

integrate multimedia into any 
database 

extended MCI device drivers (optional) 
fastest graphics engine 
all industry standard file formats 
thumbnail object producer 
capture still frames from video and 
animation 



inde^ 


create “hot spots” from video, 
graphics, animation or thumbnails 


free tech support, royalty-free 
runtime, 30 day money back guarantee 



le\r ® 


MediaDeveloper 


MediaDeveloper™ 2.0 


MULTIMEDIA APPUCATION BUILDER FORWINDOWS & NT 


le/V/el 

LENEL SYSTEMS W INTERNATIONAL INC. 
290 Woodcliff Office Park 
Fairport, NY 14450-4212 
Fax (716) 248-9185 


CALL FOR DEMO DISK 
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any new messages, so we developed a Visual Basic NO¬ 
TIFY. To find the user's mail directory, the application 
needs to determine the user's NetWare login name and 
preferred application. 


Finding the login name involves several functions in 
nwcalls.dll, a DLL supplied by Novell as part of the Net¬ 
Ware Requester, global.bas, in Listing 1, contains the declara¬ 
tions for the functions in nwcalls.dll, several user-defined 


Listing 1 continued 



gFromText = MidSCTextFile, 7, 25) 

Din DirName As String 

End If 

Dim TextFile As String 


Dim FileNum As Integer 

If LeftSCTextFi le. 8) = "Subject:" Then 

Dim count As Integer 

gSubjectText = MidSCTextFi 1 e. 10, 25) 

End If 

'Scan the user’s application directory for new messages 

Loop 

gScanNext = True 


DirName = DirtCMHSDirectory. ATTR NORMAL) ’ Get first file name. 

'Hide the notify window 

Do While gScanNext And DirName <> "" 

'and show the header window 

FileNum = FreeFile 

Notify.Visible = False 

Message.Show 1 

Open MHSDirectory & DirName For Input As FileNum ’ Open file. 

End If 

TextFile = ReadLine(FileNum) 

Close FileNum 

DirName = Dir$ ’ Get another file name. 

'If we have the Signature 

Loop 

If Left$(TextFile, 6) = "SMF-71" Then 


Do While Not EOF(FileNum) 

Notify.Visible = True 

TextFile = ReadLine(FileNum) 

Unload Message 

End Sub 

'Check for the fields of Interest 


If LeftttTextFile, 5) * "Date:" Then 

Function GetMHSDirectory (user As String) As String 

gDateText = MidStTextFile, 7, 25) 


End If 

Dim ccode As Integer 

Dim connID As Integer 

If LeftSCTextFile. 5) = "From:" Then 

Dim connNum As Integer 
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types, constants, global variables, and several functions. 
One of these functions, GetMHSDirectoryO, obtains the de¬ 
fault connection ID with NHGetDefaultConnectionID() and the 
connection number via NUGetConnectionNumberO. After re 


trieving the connection ID and number, the function calls 
NUGetConnectionlnformationO to find the user's logn name. 

MHS uses several environment variables to help specify 
the directories needed. The MV variable specifies the drive 


Listing 1 continued 

Dim tokNum As Integer 

If Len(mailPath) > 0 Then 

Dim nwUser As USER INFO 

userPath = mailPath 

Dim mail Path As String 
'Dim user As String 

Else 

Dim userPath As String 

'Otherwise get the server on the default connection 

Dim server As String 

'and the SYS volume and create a UNC path with it 

Dim serverName As String * 48 

ccode = NWGetFileServerNameiconnID, serverName) 

NullStrip (serverName) 

'Initialize NWCALLS 

userPath = "\\" 4 server 4 "\SYS" 

ccode = NWCalIsInitCByVal 0&, ByVal 04) 

End If 

'Get the default connection id and connection number 

GetMHSDirectory = userPath 

ccode = NWGetDefaultConnectionlD(conn ID) 

End Function 

ccode = NWGetConnectionNumber(connID, connNum) 

Sub NullStrip (inString As String) 

'Get the user’s login name 

'Strip off the NULLs at the end of the string 

ccode = NWGetConnectionInformationIconnID, connNum, 

Dim nullNum As Integer 

ByVal nwUser.objectName, nwUser.objectType, 
nwUser.objectID, ByVal nwUser.loginTime) 

nul1Num = InStr(inString, Chr$(0) ) 

If (nullNum > 0) Then 

user = nwUser.objectName 

inString = Left$(inString, nullNum - 1) 

NullStrip user 

Else 


inString = Chr$(0) 

'If we have the MV environment variable, use it 

End If 

mailPath = Environ$("MV") 

End Sub 
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and directory containing the MHS directory structure. If the 
MV variable is found, I use it for the MHS directory path, 
otherwise, I create a UNC path from the server's name and 
SYS volume. MHS also uses the MAIL environment variable 


to specify the location of the MAIL subdirectory, but I ig¬ 
nored this to keep the code simple. 

Finding the user's preferred application is a bit more 
involved. The MTA not only provides message transport 


Listing 1 continued 


Function ReadLine (FileNum As Integer) 

Dim Msg As String 

Dim hdrRec As HdrEntry 

'Read characters from file until a linefeed occurs 

Dim nameRec As NameEntry 

Dim Char, TextData ' Declare variables. 

Dim applRec As ApplEntry 

Dim inString As String * 128 

Do While Not E0F(FileNum) 

Dim userNums As String 

Char = InputtFileNum, #1) ’ Get one character. 


If Char <> Chr(10) Then ’ If not linefeed. 

On Error GoTo ErrorHandler ’ Set up error handler. 

TextData = TextData & Char 

Else ’ If linefeed. 

FNum = FreeFile ’ Determine file number. 

ReadLine = TextData 

Open filePath For Random Access Read As 

Exit Function 

FNum Len = NETDIR RECORDSIZE ’ Open file. 

End If 

Get FNum, 1, hdrRec 

Loop ’ Loop if not end of file. 

If hdrRec.e_etype <> Chr$(0) Then 

ReadLine = TextData 

MsgBox "NETDIR.TAB Header Record incorrect" 

Exit Function 


End If 

End Function 


Function ReadUserData (filePath As String, user As String, 

userlndex = Asc(Mid$(hdrRec.s_niocal, 1, 1)) + 

10 * Asc(Mid$(hdrRec.s niocal, 2, 1)) 

Application As String) As Integer 

For users = 1 To userlndex 

’Read from netdir.tab until we find a record with the user’s name 

Get FNum, users + 1, inString 

’return the preferred application 


Dim FNum As Integer 

’Record type 0x02 is user name 

If Left$(inString, 1) = Chr$(2) Then 

Dim userlndex, users As Integer 

TranslateName inString, nameRec 
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but also maintains a database of users and their attrib¬ 
utes, as well as a flat file extract of the database for use 
by applications. SMF-70 calls the flat file NETDIR.TAB, as 
shown in the MHS directory in Figure 1; SMP71 uses 


smf_xs.xrt. netdir.tab consists of 128-byte records with 
three record types: header, user name, and application en¬ 
try. The Basic user-defined types for these records are 
shown in Listing 1 as the HdrEntry, NameEntry, and ApplEntry 


Listing 1 continued 


If StrComp(nameRec.e_name, user, 1) = 0 Then 
Application = nameRec.n_apps(l) 

End If 

'Record type 0x09 is application entry 
Elself Left$(inString, 1) = Chr$(9) Then 
TranslateAppl inString, applRec 
End If 
Next users 

Close FNum 

NullStrip Application 
Exit Function 

ErrorHandler: ’ Error handler line label. 

Select Case Err 

'Case 53: Msg = "ERROR 53: That file doesn’t exist." 

'Case 68: Msg = "ERROR 68: Drive " & Drive & ": not available. 

'Case 76: Msg = "ERROR 76: That path doesn’t exist." 

Case Else: Msg = "ERROR " & Err & " occurred." 

End Select 

MsgBox Msg ’ Display error message. 

Resume Next ’ Resume procedure. 

End Function 


Function ScanNewMail 0 As Integer 
'Scan the user's mail directory for new messages 
Dim DirName As String 
Dim TextFile As String 
Dim FileNum As Integer 
Dim count As Integer 

DirName = DirJIMHSDirectory. ATTRJORMAL) ' Get first file name. 
Do While DirName <> "" 

FileNum = FreeFile 

Open MHSDirectory & DirName For Input As FileNum ’ Open file. 
TextFile = ReadLine(FileNum) 

'If we have the Signature, increment new message count 
If Left$(TextFile, 6) = "SMF-71" Then 
count « count + 1 
End If 

Close FileNum 

DirName = Dirt ' Get another file name. 

Loop 

ScanNewMail = count 
End Function 
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Listing 1 continued 


Sub TranslateAppl (inString As String, applRec As ApplEntry) 

'Convert string to Application entry record 

applRec.e_etype = Mid$(inString, 1, 1) 
applRec.e_name = Mid$(inString, 2, NAMESIZE) 
applRec.a_fulIname = Mid$(inString, 11, DSCRSIZE) 
applRec.a_password = Hid$(inString, 36, PWSIZE) 
applRec.a_qtyusers = Mid$(inString, 46, 2) 
applRec.ajnaxusers = Mid$(inString, 48, 2) 
applRec.a_vercntrl = Hid$(inString, 50, 1) 
applRec.ajngmtcntrl = Mid$(inString, 51, 1) 
applRec.a_fi11 = Mid$(inString, 77) 

End Sub 

Sub TranslateName (inString As String, nameRec As NameEntry) 

'Convert string to name entry record 

nameRec.e_etype = Mid$(inString, 1, 1) 
nameRec.e_name = Midt(inString, 2, NAHESIZE) 
nameRec.n_fulIname = Mid$(inString, 11, DSCRSIZE) 
nameRec.n_password = Mid$(inString, 36, PWSIZE) 
nameRec.n_netident = Mid$(inString, 46, 1) 
nameRec.n_apps(1) = Mid$(inString, 47, NAMESIZE) 
nameRec.n_apps(2) = Mid$(inString. 56, NAMESIZE) 
nameRec.n_apps(3) = Mid$(inString, 65, NAMESIZE) 
nameRec.n_apps(4) = Mid$(inString, 74, NAMESIZE) 
nameRec.n_apps(5) = Mid$(inString, 83, NAMESIZE) 
nameRec.n_fil1 = Mid$(inString, 92, FILLSIZE) 

End Sub 

/* End of File */ 


types. smf_xs.xrt consists of 512-byte records. While 
Novell recommends using smf_xs.xrt with SMF-71 applica¬ 
tions, we found that with Basic MHS installed, the user's 
applications were not present in the file. 

The function ReadUserDataO parses netdir.tab. ReadUser- 
DataO first reads records and translates records from the 
file until the user name in the record matches the login 
name. When the match is found, the preferred application 
is the first application in the NameEntry record. 

ScanNewMailO can then scan the user's mail directory 
looking for ail files with the SMF Signature in the first line. 
The user's mail directory is formed by concatenating the 
MHS directory path, "\MHS\MAIL\USERS\," user login 
name, and preferred application into a complete path. NO¬ 
TIFY sets a timer for every 45 seconds that then calls 
ScanNewMailO to rescan the user's mail directory. 

If you double-click on the Notify form when one or 
more new messages are indicated calls DisplaySubjectsO. 
DisplaySubjectsO is similar to ScanNewMailO, except that it 
scans through each new message, searching for the Date, 
Subject, and From keywords in the file. Upon finding these 
keywords, DisplaySubjectsO assigns the value of the key- 
word-value pair to the global variables, gDateText, gSub- 
jectText, and gFromText. The Message form uses these glo- 
bals in its Form_Load() subroutine to fill in its text fields. I 
also center the form in Form_Load(). You can then scan 
through the new messages one at a time by clicking on 
Message's Next button. 
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Listing 2 notify.txt — Basic code attached to notify form 

Option Explicit 

Option Base 1 

’Read the application out of netdir.tab 
ccode = ReadUserDataCMHSDirectory A 

"MHS\MAIL\PUBLIC\netdir.tab". user, userApplication) 

Sub Form DblClick 0 


MHSDi rectory = MHSDi rectory & "MHS\MAIL\U$ERS\" 8 , user 

’If 1 or more new messages, display them 

If NewMessage > 0 Then 

A "\" & userApplication & "\" 

DisplaySubjects 

’Return the number of new messages and display it 

End If 

count = ScanNewMai 10 

End Sub 

NewMessage = count 

Sub Form_Load 0 

End Sub 

Dim count As Integer 

Dim ccode As Integer 

Sub MHSTimer_Timer () 

Dim user As String 

Dim count As Integer 

’Scan every 45 seconds 

count = ScanNewMai1 ( ) 

MHSTimer.Interval = 45000 

NewMessage = count 

'Get the user’s login name and MHS directory 

MHSDirectory = GetMHSDirectory ( user) 

End Sub 

/* End of File */ 


Conclusion 

E-mail is quickly becoming a must-have application, 
and as e-mail grows in popularity, so does the need for 
e-mail support in other applications. MHS is a file-based 


Listing 3 message.txt — Basic code attached to 
message form 


Sub EndButton_Click {) 
gScanNext = False 
Hide 
End Sub 

Sub Form_load 0 

’Center the form based on the notify form 

Dim messageLeft, messageTop As Integer 

Left = Notify.Left + (Notify.Width - Width) / 2 
Top = Notify.Top + (Notify.Height - Height) / 2 

’Fill in the fields retrieved by DisplaySubjectsO 
SubjectText = gSubjectText 
FromText = gFromText 
DateText = gDateText 
End Sub 

Sub MessagePicture_DblClick 0 

If NewMessage > 0 Then 
DisplaySubjects 
End If 

End Sub 

Sub Nextbutton_Click 0 
Hide 
End Sub 

Sub OKButton.Click 0 
ScanNext = False 
Message.Visible = False 
End Sub 

Sub Picturel_DblClick 0 

If NewMessage > 0 Then 
DisplaySubjects 
End If 

End Sub 

/* End of File */ 


specification for message handling and transport, but it 
provides great flexibility and power through the SMF for¬ 
mat. With a few lines of code and an understanding of 
SMF, you can easily create e-mail utilities and mail-en¬ 
abled applications. □ 
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LEADTOOLS' Comprehensive Imaging Development Toolkit 

In rare instances, I hove the privilege of working with 
packages void of feature-bedecked user front ends that 
need a CD-ROM's worth of documentation to master. Such 
is the case with LEADTOOLS, from LEAD Technologies 
((704) 332-5532; fax (704) 372-8161). LEADTOOLS does 
one thing - image manipulation - and does it right. 

The whole package amounts to a floppy disk and a 
book. LEADTOOLS Professional 4.0 (for both DOS and 
Windows) consists of a DLL and a library that lets you call 
the DLL. You'll need a Borland or Microsoft C compiler (or 
a compiler that is compatible enough to read standard 
.LIB files; I used Watcom C/C+ + 10.0). The product is 
also available in versions for Windows NT and Clipper, 
Visual Basic and FoxPro programmers. 

The LEADTOOLS DLL provides routines that can read, 
write and manipulate image files. It understands more 
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LEADTOOLS' manipulation functions are similarly 
diverse. You can sharpen, blur, rotate, flip, posterize, 
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function I've ever seen in professional image- 
manipulation packages is here - and then some. 
Additionally, when you tell LEADTOOLS to actually display 
an image, you can control the painting effect. It can 
"wipe" from left to right, right to left, top to bottom, or 
bottom to top. The image can "materialize" as random 
pixels ore properly illuminated. You can even have the 
image spiral into existence. 

The LEADTOOLS disk is crawling with sample programs, 
each exercising a different class of functions from the DLL. 

If you need to see what on effect looks like (some are hard 
to describe), the designers hove thankfully provided 
several "exerciser" programs in executable form, along 
with sample images. You can load on image and try out 
the effect before adding it to your program. 

Granted, the $795 price is steep, but it gets you DOS and 
Windows, plus royalty-free distribution rights to whatever 
applications you build. If I had to write my own personal 
version of Adobe Photoshop, LEADTOOLS is where I'd 
start. 

-BYTE Magazine, February, 1995, page 30 
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Direct Novell NetWare 
Printing from DOS 

Douglas Cogan 


When Novell NetWare first came on the scene, existing commercial software 
did not support it. No programs recognized NetWare volumes, user IDs, or print 
queues. Novell took a common approach to solving this problem: making new 
support services emulate functionality already available in the operating sys¬ 
tem. Command-line utilities allowed unused drive letters to be mapped to net¬ 
work volumes, while the Capture program routed remote printers through exist¬ 
ing LPT services. This was an elegant solution in its day, and it has allowed 
many applications to run unmodified. Indeed, many DOS software developers 
do not give Novell NetWare much thought when designing a new system. 
They know that if they access drives and printers in standard ways, the net¬ 
work drivers will handle the rest. 

Meanwhile, end users seemed content with running Capture at the DOS 
prompt in order to receive remote print services. Microsoft Windows, however, 
spoiled them when it gave them the ability to change the destination of a 
network print job from within an application. Having experienced the freedom 
of Print Manager, users were no longer willing to accept the captivity of the 
Capture utility. Being forced to run a utility before running the application 
seemed a clunky work-around - and one that made DOS apps look all the 
more obsolete. 

This article shows you how to include in your DOS programs the functional¬ 
ity your users receive from Windows: the ability to choose a print queue from 
a list and change destinations on the fly without running Capture at all. To 
demonstrate the technique, 1 will build a DOS command-line utility called 
Qprint. qprint.h (Listing 1) includes prototypes and structures for Qprint; net¬ 
ware, asm (Listing 2) contains the low-level interface to NetWare; and qprint.c 
(Listing 3) contains the C code that is the meat of the program. 


Douglas Cogan is manager of Editorial Systems at CCH, Inc., a Fortune-500 provider of 
tax-based research materials and systems, tax-compliance software, and knowledge- 
based products. He has been a leader on the company's DOS and Windows on-line 
and CD-ROM research product, "CCH CD-ROM and On-line," and currently is develop¬ 
ing an object-oriented SGML data repository. He can be reached at 
Doug_Cogan@CCH.COM or at (708) 387-9020. 
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Listing 1 Commands and structures for NetWare access 


Mefine GETJJSERJD 0x16 
Mefine CREATEJOB 0x68 
#defi ne STARTJOB 0x69 
#define GETJINDERYJD 0x35 
Mefine SCAN-BINDERY 0x37 

Me fine CONNECTJDJABLE 3 
Mefine SERVER_NAME_TABLE 4 
Meflne PRINT.QUEUE 3 
Mefine SERVER_NAME_SIZE 48 
Mefine CONNECTJNFOJIZE 32 

Mefine BANNER_MASK 0x8000 
Mefine NOTIFYJASK 0x1000 
Mefine N0F0RM_MASK 0x0800 
Mefine DEFAULT-MASK 0x4400 

Mefine SWAPBYTES(x) ((x) « 8 I (x) » 8) 

extern unsigned char GetConnection(void); 
extern char far *GetNetwareTable(int table); 
extern int Netwarelnterfacelvoid far ‘requestBuffer, 
void far *reply8uffer, 
int functionCode); 

extern void SetPreferredConnectionlint Connection); 

struct GetBinderyIDRequest { 
unsigned int BufferLength; 
unsigned char RequestType; 
unsigned int ObjectType: 
unsigned char NameLength; 
unsigned char 0bjectName[48]; 

}; 

struct GetSinderyIDReply { 
unsigned int BufferLength; 
unsigned long ObjectID; 
unsigned int ObjectType; 


unsigned char 0bjectName[48]; 

}; 

struct CreateJobRequest { 
unsigned int BufferLength; 
unsigned char RequestType; 
unsigned long QueuelD; 
unsigned char ClientStation; 
unsigned char TaskNumber; 
unsigned long ClientID; 
unsigned long TargetServer; 
unsigned char ExecutionTime[6]; 
unsigned char EntryT1me[6]; 
unsigned int OobNumber; 
unsigned int JobType; 
unsigned char JobPosition; 
unsigned char JobFlags; 
unsigned char JobFileName[14]; 
unsigned char JobFileHandle[6]; 
unsigned char Server; 
unsigned char SeverTaskNumber; 
unsigned long ServerlD; 
unsigned char Description[50]; 

/* The following area varies by job type; 

What is shown only applies to print jobs. */ 

unsigned char VersionNumber; 
unsigned char TabSize; 
unsigned int Copies: 
unsigned int Flags; 
unsigned int MaxLines; 
unsigned int MaxChars; 
unsigned char FormName[16]; 
unsigned char Reserved[6]; 
unsigned char Banner[13]; 
unsigned char BannerFI1eName[13]; 
unsigned char HeaderFi1eName[14]; 
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Listing 1 continued 

unsigned char Path[80]: 

unsigned char ExecutionTime[6]; 

unsigned char SeverTaskNunber; 

h 

unsigned char EntryTime[6]; 

unsigned long ServerlD; 


unsigned int JobNumber; 

); 

struct CreateJobReply { 

unsigned int JobType; 


unsigned int BufferLength; 

unsigned char JobPosition; 

struct StartJobRequest { 

unsigned char ClientStation; 

unsigned char JobFlags: 

unsigned int BufferLength; 

unsigned char ClientTaskNumber; 

unsigned char JobFileName[14]; 

unsigned char RequestType; 

unsigned long ClientID; 

unsigned char OobFileHandle[6]; 

unsigned long QueuelD; 

unsigned long TargetServer; 

unsigned char Server; 

unsigned int JobNumber; 


Novell publishes extensive technical information re¬ 
garding programming to its API. For this article i examined 
NetWare System Interface Technical Overview and NetWare 
System Calls - DOS, which came bun¬ 
dled with a large SDK. Novell now 
produces a CD subscription for $195 
and includes a large amount of docu¬ 
mentation. While this is useful, I did 
not find in the literature that I exam¬ 
ined a one-stop description of how to 
print to the network queues. Some of 
the information that follows I learned 
by setting breakpoints on DOS calls 
using Soft-ICE and running the NPrint 
program. 


structure, excluding the length field itself. The next two 
bytes of the request structure contain the command num¬ 
bers. Depending on the function to be performed, the 


NetWare Calling Conventions 

The programming interface to 
NetWare is straightforward and ele¬ 
gant. Since its designers considered 
NetWare an extension of MS-DOS, 
you issue a NetWare command as 
you would call a DOS function: load 
the function number into AX and exe¬ 
cute I NT 21h. Most functions accept a 
request structure pointed to by DS:SI 
and return output in a reply structure 
pointed to by ES:DI. Such functions 
return a result code in AX, where 0 
denotes success, and any other num¬ 
ber is an error code. Novell has 
changed the calling convention 
somewhat between NetWare 3.x and 
4.x, so users of NetWare 4.x and 
above must load netx. vim to emulate 
the convention described here. 

qprint.h (Listing 1) shows the pro¬ 
totypes of functions that access Net¬ 
Ware. The most commonly used is 
NetUarelnterfaceO, which accepts 
pointers to input and output struc¬ 
tures and returns the NetWare result 
code. The code to implement these 
NetWare interface routines is in net¬ 
ware, asm (Listing 2). The input and 
output structures vary for each differ¬ 
ent function, but the first two-byte 
field of each structure is an integer 
value specifying the length of the 
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Listing 1 continued 


struct StartJobReply { 
unsigned int BufferLength; 

}; 

struct GetConnectionlnfoRequest { 
unsigned int BufferLength; 
unsigned char RequestType; 
unsigned char Connection; 

}; 

struct GetConnectionlnfoReply { 
unsigned int BufferLength; 
unsigned long ObjectID; 
unsigned int ObjectType; 
unsigned char 0bjectName[48]; 
unsigned char LoginTime[7]; 
unsigned char Reserved; 


struct ScanBinderyRequest { 
unsigned int BufferLength; 
unsigned char RequestType; 
unsigned long LastObjectID; 
unsigned int ObjectType; 
unsigned char NameLength; 
unsigned char 0bjectName[48]; 

}; 


struct ScanBinderyReply { 
unsigned int BufferLength; 
unsigned long ObjectID; 
unsigned int ObjectType; 
unsigned char 0bjectName[48]; 
unsigned char ObjectFlag; 
unsigned char ObjectSecurity; 
unsigned char Properties; 

}; 

/* End of File */ 


body could contain strings of text, 2- 
byte or 4-byte integers, or bit fields. 
Unfortunately for us PC program¬ 
mers, values are stored in the struc¬ 
ture in big-endian form (most signifi¬ 
cant bytes precede least significant 
bytes), except for the initial 2-byte 
length field, which is stored in the proc¬ 


essor native format. The macro SUAP2 
will convert from native Intel format to 
what NetWare expects. 

Using the NetWare Interface 

The first step in any application 
that calls NetWare directly is to verify 
that the user has the network soft- 


Listing 2 Wrapper functions for NetWare interrupt 

.MODEL LARGE 


pop 

di 

.CODE 


pop 

si 



pop 

ds 

public Jetwarelnterface 

pop 

es 

public _SetPreferredConnectlon 

pop 

bp 

public GetNetwareTable 

xor 

ah, ah 

public GetConnection 


ret 




Netwarelnterface endp 


Netwarelnterface proc far 



push 

bp 

_SetPreferredConnection 

proc far 

mov 

bp, sp 

push 

bp 

push 

es 

mov 

bp, sp 

push 

ds 

push 

dx 

push 

si 

mov 

dx, [bp+6] 

push 

di 

mov 

ax, 0F000h 

mov 

si, [bp+6] 

int 

21h 

mov 

ax, [bp+8] 

xor 

ah, ah 

mov 

ds, ax 

pop 

dx 

mov 

di, [bp+10] 

pop 

bp 

mov 

ax, [bp+12] 

ret 


mov 

es. ax 

SetPreferredConnection 

endp 

mov 

ax, [bp+14] 



int 

2lh 

_GetNetwareTable proc far 
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ware loaded and is logged on to at 
least one file server. Each file server 
stores a list of the users logged on to 
it, along with other connection infor¬ 
mation. The function GetConnectionO 
retrieves the position in this list of 
the machine making the call. After 
obtaining the connection number, 
you can use it to find the ID of the 
user who logged in. Pass the connec¬ 
tion number in the GetConnectionln- 
foRequest structure and call NetUareln- 
terfacet). NetWare will fill in the re¬ 
ply structure, yielding, among other 
things, the login ID of the specified 
connection in the ObjectName field. If 
this field is not filled in, you can be 
certain that either Novell NetWare 
is not running, or the user is not 
logged in. 

Note that one of the elements re¬ 
turned in the GetConnectionlnfoReply 
structure is named ObjectID. This ID 
refers to an object in the file server's 
bindery. The bindery can be seen as 
simply a large database which is lo¬ 
cated on the file server and which 
contains important information on 
many different "objects". Many types 
of objects store their information in 
the bindery: users, print queues, and 
other file servers ail have entries 
here. These objects are accessed 
through 32-bit tokens called object 
IDs. The ID passed back in the Get¬ 
ConnectionlnfoReply structure is the to¬ 
ken for the user logged in on that 
machine. 

Print jobs are submitted to print 
queues through two NetWare com¬ 
mands: CREATE_JOB {0x68) and 

START_J0B (0x69). (These functions can 
be used to issue jobs to other types 
of queues, but only print queues are 
germane to this discussion.) qprint.h 
(Listing 1) contains the CreateJobRe- 
quest structure, which is divided into 
two halves: a generic section which 
applies to all types of jobs, and a job- 
specific section whose format 
changes based on the type of job 
specified. The generic section stores 
parameters such as the ID of the 
queue which will handle the job and 
the time at which the server should 
process the job. (A start time field 
filled with 0xFF 's causes the server to 
start right away.) 


Listing 2 continued 

push 

bp 

_GetNetwareTable endp 


mov 

bp, sp 



push 

si 

_GetConnection proc 

far 

push 

es 

mov 

ax, 0DC00h 

mov 

ax, [bp+6] 

int 

21h 

mov 

ah. 0EFh 

xor 

ah, ah 

int 

21h 

ret 


mov 

ax, si 

_GetConnection endp 


mov 

dx. es 



pop 

es 

end 


pop 

si 



pop 

bp 

/* End of File */ 


ret 
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Listing 3 Source code for Qprint program 


♦include <stdio.h> 

rootname = FileName; 

♦Include <1o.h> 

else 

♦include <fcntl .ti> 

rootname++; 

♦include <string.h> 


♦include <memory.h> 

memset(&Reply, 0, sizeof(Reply) ) ; 

♦include <stdlib.h> 

memsetf&Request. 0, sizeof(Request) ) ; 

♦include “qprint.h" 


/* Global Variables */ 

/* Set up generic part of job structure */ 

Request.BufferLength = sizeof(Request)-2; 

char *FileName; 

Request.RequestType = CREATE_JOB; 

char UserName[50]; 

Request.QueuelD = QueuelD; 

Int MaxServers; 

Request.TargetServer = 0xFFFFFFFF; 

int GetUserlDCunsigned char ConnectNo, char *userID) ( 

Request.JobType = 0; 

Request.JobFlags = 0x10; 

struct GetConnectionlnfoRequest Request; 

memset(Request.ExecutionTime, 0xFF, 6); 

struct GetConnectionlnfoReply Reply; 

Request.VersionNumber = 0; 

unsigned int retCode; 

Request.TabSize = 8; 

memsetURequest. 0, slzeofCRequest )) ; 

Request.Copies = SWAPBYTES(l); 

Request.Flags = NOTIFY MASK I BANNER MASK 

Request.BufferLength = sizeof(Request)-2; 

1 DEFAULT MASK; 

Request.RequestType = GET USER ID; 

Request.MaxLines = SWAPBYTES(66) ; 

Request.Connection = ConnectNo; 

Request.MaxChars = SWAPBYTES(132); 

memsetUReply, 8. sizeof (Reply) ); 

strcpyCRequest.FormName, "Standard" ); 
strcpyCRequest.BannerFiTeName. rootname) ; 

Reply.BufferLength = sizeof(Reply)-2; 

strcpytRequest.HeaderFi 1 eName, rootname ); 

retCode=NetwareInterface(&Request, iReply, 0xE300) ; 

strcpy(Request.Description, "Made with QPrint"); 
strncpy(Request.Path, FileName, rootname-FileName) ; 

strcpyCuserlD, Reply.ObjectName) ; 

strcpy ( Request.Banner, UserName ); 

return retCode; 

Reply.BufferLength = sizeof(Reply ) -2; 

unsigned int CreateJobtunsigned long QueuelD) { 

/* Now submit the job request to NetWare. */ 
if (NetwarelnterfaceURequest, &Reply. 0xE300) ) 

struct CreateJobRequest Request; 

return 0xFFFF; 

struct CreatedohReply Reply; 

else 

char ‘rootname; 

return Reply.JobNumber; 

rootname = strrchrtFileName, *\\*); 


if (rootname==NULL> 

int StartOobCunsigned long QueuelD, 

rootname = strrchr(FileName, 

unsigned int JobNumber) { 

if (rootname==NULL) 

struct StartJobRequest Request; 
struct StartOobReply Reply; 
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The CreateJobRequest structure also contains a field to 
specify which job server is to process the job, in the case 
where more than one server is connected to a given 
queue. If you wish a certain print server to service a print 
job, place its bindery object ID in this field; set the field to 
0xFFFFFFFF to indicate that there is no preference. The sec¬ 
ond half of the CreateJobRequest structure contains options 
that are specific to print queues, it is here that you can set 
the various parameters available from the NPrint com¬ 
mand line: whether to print a banner page, and whether 
you are to be notified with a network broadcast message 
when the job is finished. You can also customize what is 
printed on the banner page by filling in the BannerFileName, 
HeaderFileName, and other fields. Note, 
however, that older versions of Net¬ 
Ware do not necessarily support 
every field. 

The actual process of printing a 
file is relatively straightforward. First, 
use the command GET_BINDERY_ID 
( 0x35} to determine the bindery object 
ID of the destination print queue. Fill 
in the CreateJobRequest structure as 
appropriate and issue the CREATE_JOB 
command. Next, open the special 
network device NETO as you would 
open a file. Copy to this device each 
byte that you wish printed. When all 
bytes are copied, close the file and 
issue the START_J0B {0x69) command, 
submitting to NetWare the job ID re¬ 
turned in the CreateJobReply structure. 

The print server will detect that a 
print job is in the queue and will 
service it. 

As you saw earlier, the print 
queue object ID is determined by 
querying the file server. The algo¬ 
rithm, therefore, only works for one 
given file server at a time. Since it is 
possible to be connected to multiple 
file servers, any worthwhile system 
must be capable of printing to any 
queue on any server to which the 
user has established a connection. 
qprint.h (Listing 1) makes reference 
to GetNetMareTableO which returns a 
pointer to one of many internal Net¬ 
Ware tables. One such table is the 
Server Name Table, which is simply 
an array of 48-byte strings containing 
the names of all file servers to which 
the user is connected. This table con¬ 
tains a maximum of eight entries. 

Note that the server names are not 
arranged in any significant order, and 
that the presence of an unused entry 
does not indicate the end of the list. 

A second table, the Connection Info 
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Listing 3 continued 


unsigned int retCode; 

memsetUReply, 0, sizeof(Reply)); 
memsetURequest, 0. sizeof(Request)); 

Request.BufferLength = sizeof(Request)-2: 

Request.RequestType = START_J0B; 

Request.QueuelD = QueuelD; 

Request.JobNumber = JobNumber; 

Reply.BufferLength = sizeof(Reply)-2; 

/* Now submit the job request to NetWare. */ 
retCode=NetwareInterface(&Request. &Reply, 0xE300); 

If (retCode != 0) 

printf("Start Job error: X1\n", retCode); 
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Table, indicates which entries in the Server Name Table 
are valid. The Connection Info Table points to an array of 
32-byte structures. The first byte of each structure contains 
a non-zero value if the corresponding entry in the Server 


Name Table is valid. In order to iterate over all connections, 
loop through the Connection Info structures, checking each 
32nd byte. If the byte is non-zero, the corresponding entry 


Listing 3 continued 


return retCode; 

} 

unsigned long GetQueueID(char *QueueName) { 
struct GetBinderyIDRequest Request; 
struct GetBinderyIDReply Reply; 
memset(&Reply, 0, sizeof(Reply)): 
memsetURequest, 0, sizeof (Request)); 

Request.BufferLength = sizeof(Request)-2; 

Request.RequestType = GET_BINDERY_ID; 

Request.ObjectType = SWAPBYTES(PRINT_QUEUE); 

Request.NameLength = strlen(QueueName); 

strcpy(Request.ObjectName. QueueName); 

Reply.BufferLength = sizeof(Reply)-2; 

if (NetwareInterface(&Request, &Reply, 0xE300)==0L) 
return Reply.ObjectID; 
else 

return 0XFFFFFFFF; 


void CopyFile(int outHandle. int inHandle) ( 
char tempBuffer[80]; 
int returnCode; 
do { 

returnCode = read(inHandle, tempBuffer, 80); 
if (returnCode > 0) 

write(outHandle, tempBuffer, returnCode); 


} while (returnCode >0); 

} 

int GetServerConnection(char *serverName) { 
char *FileServerArray, *ConnectInfo; 
int loop; 

ConnectInfo=GetNetwareTable(CONNECT_ID_TABLE); 

FileServerArray=GetNetwareTable(SERVER_NAME_TABLE); 

for (1 oop=0; 1 oop<MaxServers; 1 oofH-*-) { 
if (ConnectInfo[CONNECT_INFO_SIZE * loop] !=0 && 
strcmpKserverName, FileServerArray + 

(SERVER_NAME_SIZE*loop))==0) 

return loop+1; 

} 

return 0; 

} 

void ListAllQueues(void) { 
char *F11eServerArray, *ConnectInfo; 
int loop; 

struct ScanBinderyRequest Request; 
struct ScanBinderyReply Reply; 

memset(LReply, 0. sizeof(Reply)); 
memset(LRequest. 0, sizeof(Request)); 

Request.BufferLength = sizeof(Request)-2; 

Request.RequestType = SCAN.BINDERY; 

Request. ObjectType = SWAPBYTES(PRINTJUEUE); 


Request.NameLength = 48; 

Request.LastObjectID = 0xFFFFFFFF; 
strcpy(Request.ObjectName, "*"); 

Reply.BufferLength = sizeof(Reply)-2; 

ConnectInfo=GetNetwareTable(CONNECT_ID_TABLE); 
FileServerArray=GetNetwareTable(SERVER_NAME_TABLE); 
printf("Available print queues are:\n"); 
for (loop=0;loop<MaxServers;loo[H-*-) ( 
if ( *(ConnectInfo+CONNECT_INFO_SIZE*loop)) { 
SetPreferredConnection(loop+l); 

Request.LastObjectID = 0xFFFFFFFF; 
while (NetwareInterface(&Request, iReply, 

0xE300) == 0L) { 

printf("Xs\\Xs\n", FileServerArray+ 

SERVER_NAME_SIZE*1oop. Reply.ObjectName); 
Request.LastObjectID = Reply.ObjectID; 

} 

} 

} 

} 

void maindnt argc, char *argv[]) 

{ 

char *QueueName; 

unsigned long QueuelD; 

unsigned int JobNumber; 

int inHandle, outHandle, ServerConnection; 

unsigned char ConnID; 

MaxServers = 8; 
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in the Server Name Table contains the server which that 
connection points to. 

You can direct all bindery requests to any of the serv¬ 
ers listed in the Server Name Table via SetPreferredConnec- 
tion(). Pass to this function the entry 
in the Server Name Table containing 
the server name to use, plus one. If 
you do not specify a preferred con¬ 
nection with this function, NetWare 
will route all bindery requests to the 
default connection, which points to 
the server you initially logged into, 
and will ignore any further servers 
you attached to. If you are running 
NetWare version 3.x or lower, the 
Uhoami command will indicate your 
default connection: the server logged 
in to, rather than attached to, is the 
default. 

When an application terminates, 

NetWare automatically deactivates 
any preferred connections, rerouting 
all bindery requests to the default 
connection. You can do this manu¬ 
ally in a program by calling Set- 
PreferredConnectionO with the 
value 0. 

Given what I've covered so far, 
you should be able to print to any 


queue, given the queue name and the server it is con¬ 
nected to: scan through the Server Name Table to find the 
entry which matches the server name passed in; pass the 
entry number plus one to SetPreferredConnectionO ; then 


Listing 3 continued 

ConnID=GetConnect1on( ): /* Get connection number */ 

OueueName = argv[2]; 

if ((GetUserlDtConnID, UserName) != 0) 11 

QueuelD = GetQueuelO(OueueName); 

(UserNatne[0]=0) ) { 

if (QueuelD == BxFFFFFFFF) { 

prlntfCYou are not logged in to Novell An”); 

printfCCould not find Queue %s.\n",QueueName); 

exlt(l); 

} 

exit(l); 

) 

If (argc != 3 IS argc != 4) { 

JobNumber = CreateJob(QueuelD); 

printfC’Usage: Qprint filename queue [Server]\n")t 

If (JobNumber = BxFFFF) { 

ListAUQueuesO; 

printfCCould not create job.Xn"); 

exlt(l); 

} 

exlt(l); 

} 

if (argc == 4) { 

ServerConnection=GetServerConnect1on(argv[3]); 
if (ServerConnection = 8) { 
printfCYouTe not logged into lSs\n", argv[3]); 
exit(l); 

} 

SetPreferredConnectionlServerConnection ) : 

outHandle = openCNETQ", 0_RDWR); 
if (outHandle < 8) { 

printfCCould not open NETQNn"); 
exit(l); 

} 

CopyFi 1 e(outHandle, inHandle); 

} 

close(outHandle); 

closednHandle); 

FileName - argvfl]: 

StartJob(QueuelD, JobNumber); 

inHandle = openifileName, 0 RDONLY): 

printfCFile Sts submitted to queue Sts\n", FileName, 

If (inHandle < 8) { 

QueueName); 

printfCCould not open file %s\n",FileName); 
exit(l); 

) 

} 

/* End of File */ 
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performance loss). No bound control can say that! 

► Table view of Databases (ODBC, SQL, Paradox, DBase, 
Foxpro, etc.). Because our control puts you in charge, you 
can integrate it with any database driver you wish. Even 
integrate proprietary databases or arrays! 

► Features Galore! Mulitple highlighing, multiple selection, 
linked tables, fit-to-screen, best-fit column sizing, flexible row 
height, selectable fonts, selectable colors and much more. 

► Includes hundreds of lines of usable demonstration code, 
so you can get started right away! 

► Great for Databases, arrays, list boxes, spreadsheets, 
mailing lists, and much much more. 

► Full source code available for $ 249.00 

► Includes both 16-bit and 32-bit Windows™ DLLs. 

► Money back guarantee. If you don’t think this is the best 
Grid control you’ve ever had, we’ll give you your money back. 

► Call Today! Visa, Amex, cheque or money order. We will 
deliver via internet, CompuServe, mail or courier. The prices 
shown are in U.S. dollars. 


DUNDAS 


SOFTWARE 


dundas@the-wire.com 
Sales: (800)463-1492 
Voice: (416) 239-7472 
Fax: (416)239-2183 


202-4800 Dundas Street West 
Etobicoke, Ontario M9A 1B1 


240 Portage Rd., Suite 670 
Lewiston, NY 14092 


Windows is a registered trademark ot Microsoft Corp. All other products are trademarks or registered trademarks of their respective owners. The data in the above table is ficticious. 


April 1995 


□ Request Reader Service #282/Fax #1101 □ 


Windows/DOS Developer’s Journal — Page 31 



























































use GETJINDERYJD (0x35) to find the ID of the queue on 
the specified server. Once you have the queue ID, issue a 
CREATE_JOB, print to the NETQ file, and issue ST ART JOB. If the 
user is not logged into the requested server, the server 
name will not be found in the table, and the application 
should display an error message. You should be able to 
present a list of logged-in servers as well: scan through 
the Connection Info Table and output every entry in the 
Server Name Table for which the first byte of the corre¬ 
sponding entry in the Connection Info Table is not 0. 

Listing Available Print Queues 

To build a system as flexible as Print Manager, you 
need only add the capability to list all available print 
queues. You can do this via the NetWare command 
SCANJINDERY (0x37), which will return the object name and 
object ID for objects of the specified type. To list all print 
queues, set the ObjectType field of the ScanBinderyRequest 
structure to type 3 (remember to swap the bytes to 0x0300) 
and fill in the ObjectName field with which is the wild¬ 
card. The LastObjectID field in the ScanBinderyRequest struc¬ 
ture should be set to 0xFFFFFFFF. After the command is 
executed, the response buffer contains the object ID and 
name of the first match. Insert this ID into the LastObjectID 
field and call NetWare again. By iteratively performing 
SCANJINDERY commands, you can get a list of all print 
queues on a given server. SCANJINDERY can be a valuable 
network investigation tool. You can list all file servers 


(type 4) or all users (type 1); you can list all objects of any 
type by inserting 0xFFFF in the ObjectType field of the Scan¬ 
BinderyRequest structure. 

qprint.c (Listing 3) contains the complete QPrint pro¬ 
gram. Compile the program large model and make sure 
structures are byte aligned. Run the program by typing 

QPrint filename queue [server] 

where "filename' is the file you want printed, "queue' is 
the destination print queue, and 'server' is the name of 
the file server to which the print queue is connected. The 
server parameter is optional; it is omitted, QPrint will look 
for the specified queue on the default file server. If no 
parameters are issued, QPrint will display its syntax and 
list all print queues on all servers to which the machine 
has a connection. In your own application, you can pre¬ 
sent this list in a listbox to allow the user to choose the 
destination, if you wish. 

Summary 

The NetWare API is very powerful. Understanding the 
bindery and how to call it lets you use even the few func¬ 
tions described here to provide increased power to your 
applications. And perhaps the ability to change print 
queues on the fly will breathe new life into that old DOS 
app of yours that just can't be ported to Windows. □ 


Industrial Strength 
Applications! 


WIN-PROLOG - [Console] 


I s»| File Edit Search Run Options Window 

Build industrial strength applications for the industry 
standard platform, Windows 3.1! Robust, intelligent 
applications which yield the full 32-bit power of your PC. 

And with LPA-PROLOG, build them the easy way: 

High level handling of dialogs, menus and graphics 
Powerful DLL, DDE and ODBC interfaces 
Compact, fast and royalty-free runtime system 

Not to mention the integrated source level debugger, 
multi file program editor, incremental and optimising 
compilers, and full Prolog predicate library. 
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DbCAD dev 1.3 is a library of functions which can be 
used from any programming environment compatible 
with the DLL standard (C++, Visual Basic, FoxPro, etc.). 

It adds to the selected programming language functions 
that allow you to: 

- Manage a graphic window where you can find pan, 
zoom, overview and copy buttons; 

- Display Raster images (BMP, RLE, RLC) on which 
you can overlay Vector drawings (DWG, WMF and 
DbCAD dev Graphic DBF); 

- Print graphic images (raster and vector) and text by 
using Windows driver and fonts; 

- Create, select, edit, import (from DXF and DWG files), 
all the AutoCAD 2D vector entities, including 
properties. These entities are stored in a graphic database 
(standard DBF) and each of them is attached to an 
identifier that can be used for linking with alpha¬ 
numeric database records. 


Developed by 
ABACO 
Via A.Sacchi 8a 
46100 Mantova-ltaly 
fax +39 376 222182 
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Communications 


Identifying UARTs, 
Their Ports, and IRQs 

Mike Dawdy 



Recently I was once again trying to help a friend upgrade a PC. This time it 
involved installing a hard drive and an internal modem. We had no documen¬ 
tation for the modem. I ran a DOS program, magic.exe, which I had written 
some years ago and it immediately revealed the I/O address, interrupt request 
(IRQ) assignment, and designation of all serial devices in the machine. The 
program's output looks like this: 

I/O address = 2f8, Designation = NS16450, IRQ = 3 
I/O address = 3f8, Designation = NS16450, IRQ = 4 

I also learned where an interrupt conflict was occurring, since the program 
looks for the case where two serial devices are using the same IRQ. magic.exe 
reads hardware device data only - it does not access any BIOS or operating 
system data areas. I have run versions of it under DOS, Windows 3.x, and 
QNX. 

The February 1995 Dr. Dobbs Journal contains an article, "Identifying Serial 
Port IRQs," in which John Ridley discusses a similar technique. The code that I 
present here is different in two respects. First, in identifying which I/O port 
addresses belong to UARTs, this code does not write to the port; instead, it 
uses read instructions only, a much safer technique. Second, in determining the 
IRQ assignment for the port, it reads the Interrupt Request Register (IRR) and 
In-Service Register (ISR) of the 8259A Programmable Interrupt Controller (PIC). 
This is an absolutely certain technique for determining which interrupts are 
pending, and it obviates any hairy timing problems. 


Mike Dawdy teaches computer programming at Fanshawe College in London, Ontario, 
Canada and is proprietor of Multi-MIPS Hi-tech Software. Mike has been interested in 
the technical aspects of computers since learning machine language on an IBM 7040 
in 1965. He can be reached on CompuServe at 76275,700. 
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Table 1 Overview of UART register usage 

Address 

Description 

Abbreviation 

base+0 

Transmit/Receive Buffer Register 

(TRB) 

base+1 

interrupt Enable Register 

(IER) 

base+2 

Interrupt Identification Register 

(HR) 

base+2 

(write) FIFO Control Register 

(FCR) 

base+3 

Line Control Register 

(LCR) 

base+4 

Modem Control Register 

(MCR) 

base+5 

Line Status Register 

(LSR) 

base+6 

Modem Status Register 

(MSR) 

base+7 

Scratch Register 

(SCR) 



The SQL DBMS of choice for 
developers who want scalability, 
interoperability and price/performance 

Quadbase-SQL is the only industrial-strength, ANSI SQL 89 DBMS that allows 
you to develop and deploy your applications in stand-alone environments such 
as individual notebooks or desktops as well as in LAN environments, 
including both peer-to-peer and client/server configurations. 

Quadbase-SQL for Windows can support your stand-alone applications 
as well as workgroup, multi-user applications on a network without a 
dedicated server. It can run on any DOS/Windows-compatible 

network. Network independence and ease-of-use allow 
your applications to operate in a potentially large 
installation base, 

Quadbase-SQL Server offers true client/server 
functionalities. Running under NetWare and 

Windows NT, it fully utilizes the multi-threading 
capabilities of the operating systems. Asynchronous 
I/O is supported for optimum performance. It is SMP- 
ready under Windows NT. 

For interoperability, an ODBC level 2 driver is included to serve as a native API to the 

Quadbase engine. The lack of complicated API 
mapping and intermediate data buffering/ 
translation further enhances its performance. 

Prices start at $100. Don’t allow our 
extremely attractive pricing to throw you 
for a loop. Quadbase-SQL offers many 
of the advanced functionalities found 
(and not found!) in its higher-priced 
competition. Key advanced features include bidirec¬ 
tional scroll cursors, multiple BLOB fields per table, declarative referential integrity 
with triggers and SQL-2-compliant multi-table outer joins. 
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Quadbase-SQL is 
the DBMS that 
you can count on 
to build your 
most demanding 
applications. 


Please call 408-982-0835for a free demo disk or 
to receive instructions on where and how to 
download the demo immediately on-line. 

Quadbase Systems, Inc. 

■nH 2855 Kifer Road, Suite 203, Santa Clara, CA 95051 
Tel: 408-982-0835 • Fax: 408-982-0838 


UART Review 

The original IBM PC defined the interface for up to two 
serial ports, originally based on the 8250 UART family. 
Each port uses several I/O port addresses for communicat¬ 
ing with PC software. For example, COM1 uses I/O port 
addresses 0X03F8 through 0X03FF, with 0x03F8 designated as 
the device's base address. Table 1 shows how the UART 
uses the eight I/O port addresses. As I will describe later, 
the details of these UART registers provide the means for 
determining whether a UART is present at a particular I/O 
port address, and even what specific type of UART it is. 

IBM's original technical reference for the PC defined 
only two serial ports: COM1 at base I/O port address 
0X03F8 and COM2 at base I/O port 
address 0x02f8. However, a de facto 
standard emerged for supporting as 
many as four serial devices, placing 
COM3 at base I/O port address 0X03E8 
and COM4 at base I/O port address 
0X02E8. Custom serial devices might 
also elect to place UARTs at other 
base I/O port addresses. 

To achieve reasonable speeds 
without data loss, a UART must oper¬ 
ate in an interrupt-driven mode. In 
other words, if you try to poll a UART 
that is receiving data at 9600 baud, 
data overrun will result (many UARTs 
still support only a single-byte buffer 
for incoming data). You can avoid 
this problem by instructing the UART 
to generate a hardware interrupt 
each time a data byte arrives, and by 
installing a corresponding interrupt 
handler to quickly place the newly 
arrived byte in a ring buffer until 
your application has a chance to re¬ 
trieve it. 

Unfortunately, hardware interrupts 
were a very scarce resource on the 
original IBM PC, and only two were 
available for serial ports (IRQ 4 for 
COM1 and IRQ 3 for COM2). Some 
clever programmers overcame this 
limitation by having COM3 and 
COM4 share these IRQs, and then 
identifying at interrupt time which 
UART had received a character (or 
simply polling all the UARTs). With 
the PC AT, IRQs became more plenti¬ 
ful. Still, the fact that hardware 
boards often need to use a hardware 
interrupt continues to plague users, 
who must figure out what hardware 
interrupts are already in use so that 
they can set the correct jumpers to 
assign a new board an unused inter¬ 
rupt. Microsoft's Plug and Play stand¬ 
ard may eliminate this problem some 
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Listing 1 Detecting the presence of a UART 

II uart chk.c - determine if given I/O address is a UART 

inp(addr+TRB); // clear data ready 


If !(1np(addr+LSR) A 0x9f) 1= 0x00) return!FALSE); 

//include "uart.h" 

II Reading HSR forces certain bits to zero 

//define TRUE 1 

inp(addr+MSR>; // dear CTS. DSR, RI, DCD 

/(define FALSE 0 

If !(inp(addr+HSR) A 0x0f) != 0x00) return(FALSE); 


// HR bit 0 should be 1. bits 4 A 5 should be 0 

unsigned uart checkiunsigned addr) 

if !(inp(addr+IIR) A 0x31) 1= 0x01) return!FALSE); 

{ 

// LSR bits 5 and 6 should be 1 

// certain bits must always be zero 

if (( inp(addr+LSR) A 0x60) != 0x60) return!FALSE); 

if ((inptaddr+IER) 5 0xf0) 1= 0x00) return(FALSE); 

return(TRUE); 

if «1np(addr+IIR) A 0x30) != 0x00) return!FALSE): 

1 

if ((inp(addrtWCR) A 0xe0) != 0x00) return!FALSE): 


// Reading LSR and TRB forces certain bits to zero 

/* End of File */ 

1np(addr+LSR); // clear OV,PA,FR,BR,RF 



day, but that solution is still in the fu¬ 
ture and does not help millions of 
existing machines, magic.exe can help 
by locating and identifying UARTs 
and attempting to detect any inter¬ 
rupt conflicts associated with them. 

Is It a UART? 

magic.exe scans I/O ports, looking 
for UARTs. The information needed 
to determine if a particular I/O port 
address is a UART can be found in 
publications available from National 
Semiconductor Corporation (NatSem). 

I use the 1987 edition of NatSem's 
Microcommunication Elements Dat¬ 
abook because it contains informa¬ 
tion about anomalies in the UART 
chips that has been edited out of 
more recent editions. In this book, 
'Table I: UART Reset Functions,' 
which appears in the data sheets for 
each UART type, indicates that spe¬ 
cific bits in some registers are always 
zero. The bits that must be zero are: 
Interrupt Enable Register (IER) bits 4- 
7, Interrupt Identification Register (HR) 
bits 4-5, and Modem Control Register 
(MCR) bits 5-7. These form my first 
three checks for detecting the pres¬ 
ence of a UART, as shown in 
uart_chk.c (Listing 1). 

if the I/O address is a UART, then 
reading the Line Status Register (LSR) 
and the Transmit Receive Buffer Reg¬ 
ister (TRB) forces all bits of the LSR to 
zero except bits 5 and 6. This is my 
fourth check for a UART. Reading the 
Modem Status Register (MSR) forces 
bits 0-3 of the MSR to zero, which is 
my fifth check to detect a UART. 

The UART forces bits 4 and 5 of 
the Interrupt identification Register 
(HR) to be zero, and bit 0 of the UR 
(which is zero only if an interrupt is 
pending) should be 1. In other words. 



for C/C++ 

presents Bug # 542 


#include <stdio.h> 

int main() 

{ 

struct { int bit : 1; } s; 
s.bit = 1; 

if( s.bit > 0 ) printf( "bit is on\n" ); 
else printf( "bit is off\n" ); 
return 0; 

} 


There is something non-portable about this code that will give unexpected results 
on some C compilers (e.g. Microsoft). Can you spot the difficulty? Call if you 
need a hint. Refer to Bug #542. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Numerous C++Warnings and Messages: 
Are your inherited destructors virtual? Are 
your constructor new’s matched by your 
destructor delete’s? Are your initializers 
in order? Are names inadvertently hiding 
other names? Are your C++ modules 
consistent with your C modules? Much, 
much, more. 

Plus Our Traditional C Warnings: 

Uninitialized variables, unaccessed variables, 
possibly uninitialized variables, strong type 
mismatches, indentation irregularities, loss of 
precision, strange uses of Booleans, 
signed/unsigned mismatches, suspicious 
expressions, unused macros, etc. etc. 


Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

PC-lint for C/C++ $239 

Numerous compilers/ libraries supported. 
Runs on MS-DOS (Optional built-in 386 
DOS extender) and OS/2. PC-lint for C is 
still available for only $139. 

FlexeLintfor C/C+ + 

The same great product for other operating 
systems. Runs on all Unix systems, VMS, 
NT, mainframes, etc. Distributed in 
shrouded C source form. Call for pricing. 
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File Edit Bookmark Help 


fcontenti | Search j Back | History | Up | Group |p,vf,‘ivie-w| << j| >>~ 



Load Library (2.x) 


^HINSTANCE Lo ad Li b rary ( /pszLibF/feName ) 


Annotation: 


If LoadLibrary() cannot find the library, it may display an error message to the user, 
depending upon the state of Windows' "error mode". If you want to handle that case 
yourself and make sure Windows does not display the error message, see the 
documentation for the function SetErrorMode(j. For example, the following code 
attempts to load the library ctl3d.dll. but does not emit an error message if it is not 
found. 

HINSTANCE Ctl3d; 

UINT OldFlag = SetErrorMode(SEM_NOOPENFILEERRORBOX); 

Ctl3d = LoadLibr ary ("ctl3d.dll"]; 

SetErrorMode(OldFlag); H restore previous mode 
if(Ctl3d <= HINSTANCE_ERROR) 

// LoadLibraryO failed for some reason 

[SDK Annotation == free T-shirt! Send your idea to 70302.2566@compuserve.com] 
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reading the HR and ANDing it with 0x31 should produce 
0x01. Finally, in the Line Status Register (LSR), both the 
Transmitter Holding Register Empty (THRE) bit (bit 5) and 
the Transmitter Shift Register Empty (TSRE) bit (bit 6) must 
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sheets, examples, and comments from current customers. 
Vireo Software 385 Long Hill Road Vireo@vireo.com 
508-779-8352 Bolton, MAO 1740 Fax:508-779-8351 



VtoolsD is a trademark of Vireo Software, Inc. Microsoft is a registered trademark and Windows is a trademark of Microsoft Corporation. 


be 1. These are the two final checks i 
perform to decide whether a UART is 
present at a particular I/O base ad¬ 
dress. 

These seven read-only tests are 
incorporated into the function 
uart_check() in uart_chk.c (Listing 1). 
In my experience they have been 
sufficient to identify all UARTs in PCs 
without interfering with system op¬ 
eration. 

Which UART Is It? 

The National Semiconductor publi¬ 
cation referenced earlier (The Micro¬ 
communications Elements Databook) 
also details the reasons for determin¬ 
ing the designation of a UART: that 
is, whether it is an INS8250-B, an 
NS16450, an NS16550 or an 
NS16550A. In particular, the 
INS8250-B and the NS16550 contain 
anomalies which may cause your 
software to fail (the same data sheet 
contains software workarounds for 
these anomalies). Or you may simply want your software 
to use the FIFO of the NS16550A. 

The easiest UART to distinguish is the INS8250-B. Of 
the four UART types, only the INS8250-B does not contain 
a scratch register. By writing an arbitrary bit pattern to this 
register and reading it back, you can tell if the UART des¬ 
ignation is INS8250-B. 

FIFO buffers can be used to distinguish the remaining 
UART types, in order to reduce the number of interrupts 
that a UART generates during high-speed transfers, some 
UARTs have multi-byte buffers, rather than the single-byte 
buffer of the original PC UART. You can program the 
UART to generate interrupts less frequently than one per 
character. The UARTs that support FIFO buffers contain a 
FIFO Control Register (FCR), which you can manipulate by 



0x12) return(l); 


// uart_typ.c - determine type of UART 

#include "uart.h” 

unsigned uart_type(unsigned addr) 

{ 

unsigned iir; 
outp(addr+SCR, 0x12); 
if (inp(addr+SCR) != 
outp(addr+FCR, 0x01); 
iir = inpCaddr+IIR); 
outp(addr+FCR, 0x00); 
if ((iir & 0xc0) == 0x00) return(2); 
if ((iir & 0xc0) == 0x80) return(3); 
if ((iir & 0xc0) == 0xc0) return(4); 
return(0); 

) 

/* End of File */ 


INS8250-B 
enable FIFOs 

reset FIFOs 

NS16450 

NS16550 

NS16550A 

unknown 
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writing to the same address where the Interrupt Identifica¬ 
tion Register (HR) resides; the HR is a read-only register, so 
there is no conflict in having both registers share the 
same I/O address. UARTs that support FIFO buffers also 
change various bits in the HR to reflect the status of the 
FIFO buffers. 

If a UART supports FIFO buffers, then turning on bit 0 
of the FCR enables them, and, depending on the UART 
type, bits 6 and 7 of the HR will then be turned on to 
indicate that FIFO buffers are on. The NS16450 does not 
contain a FIFO Control Register (FCR), which is the key to 
identifying it: if you attempt to enable FIFO buffers on the 
NS16450, bits 6 and 7 of the HR will still be zero. On the 
other hand, bit 6 of the HR is permanently set to zero in 
the NS16550, while in both the NS16550 and the 


Listing 3 Detecting the UART IRQ level 

_ 

// uartjrq.c - determine IRQ level or IRQ conflict 

#include "uart.h" 

#include <dos.h> 

void .interrupt _far commonjsr(void); 
static volatile unsigned char irr, isr; 
static unsigned port; 

void -interrupt _far common 
{ 

outp(PIC_A0, PIC—ISR); 

10—DELAY 

isr = inp(PIC_A0); 

10—DELAY 

outp(PIC_A0. PIC-IRR); 

10-DELAY 

irr = inp(PIC-AO); 
inp(port+IIR); 

outp(PIC_A0, PIC-EOI); 

} 

unsigned char uart_irq(unsigned addr) 

{ 

void (-interrupt _far *iv_save[8])(void); 
unsigned savejmr, ticks, i; 
savejmr = inp(PIC_Al); // save state of PIC 
outp(PIC—A1, Oxbc): // allow disk, keyboard & clock only 
for (i=2: i<8; -H-i) // save vectors except disk, kb & elk, 
if (i != 6) // and point them to commonjsr 

{ 

1v_save[i] = _dos_getvect(i+8); 

_dos_setvect(i+8, commonjsr); 

) 

irr = isr = 0; // initialize global variables .. 

port = addr; // .. for interrupt handler routine 

outp(addr+MCR, MCR_0UT2); // permit UART interrupts 
outp(PIC_Al. 0x00); // enable all interrupts 

ticks = ‘(volatile unsigned far *)TICKS + 2; 

// wait max 1.x BIOS clock ticks 
outp(addr+IER, 0x02); // generate a THRE interrupt 

while ((irr+isr == 0) U (ticks 1= 

‘(volatile unsigned far *)TICKS)) 

; // wait for interrupt or timeout 

outp(addr+IER, 0x00); 

for (i=2: i<8; ++i) // restore saved intrpt vectors 

if (i != 6) 

_dos_setvect(i+8, iv_save[i]); 

// we trashed some UART registers! 
outp(PIC_Al, savejmr); // restore imr 
return irr I isr; // zero if no interrupt occurred 
} 

/* End of File */ 


Jsr(void) 

// prepare to read ISR of PIC 
// IBM AT Tech Ref page 9-8 
// read ISR 

// prepare to read IRR of PIC 

// read IRR 
// resets thr empty 
// (and it arises) 

// reset ISR bit 


Listing 4 Main program for magic.exe 


/* magic.c - list ALL serial port I/O addresses, 

* designations & IRQs. IRQ == -1 implies interrupt 

* conflict, faulty UART or bad jumper setting 
*/ 

//include <stdio.h> 

//include "uart.h" 
void main(void) 

{ 

unsigned io_addr, count; 
unsigned char irrjsr; 
int irq; 

unsigned char*name[]= 

{ 

"Unknown","INS8250-B", "NS16450" ."NS16550" ."NS16550A" 
}; 

for(io_addr=0x0100; io_addr < 0x0400; io_addr += 0x0008) 
if (uart_check(io_addr)) 

{ 

printf("\nI/0 address = £x, name = *s, ", 
i 0 —addr.name[uart_type(io_addr)]); 

// bit-n (from the right) => IRQn 
irrjsr = uart_irq(io_addr); 
irq = -1; 

for (count=0; irr_isr!=0; irr_isr»=l, ++irq) 
count += irr_isr&0x01; 

printfC'IRQ = U", (count == 1 ) ? irq : -1); 

} 

} 

/* End of File */ 
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NS16550A, bit 7 will be a 1 when the FIFOs are enabled. 
These four tests are incorporated into the function 
uart_type() in uart_typ.c (Listing 2). 

What IRQ Does the UART Use? 

The device in the PC that handles hardware interrupts 
is the Programmable Interrupt Controller (PIC). This chip 
was documented in a publication available from Intel, 


Microprocessor and Peripheral Hand¬ 
book: Volume I - Microprocessor ; 1 use 
the 1988 edition. Like the UART, the 
PIC exposes registers at specific I/O 
addresses, so you can program and 
query it. Three eight-bit registers (in 
which each bit corresponds to an IRQ 
level) provide the main interface to 
the PIC. The PIC's interrupt Request 
Register (IRR) is an eight-bit register 
you can read to see which IRQs have 
an interrupt pending. A 1 in bit-n 
(from the right) indicates IRQ/?. The 
In-Service Register (ISR) is an eight-bit 
register which indicates which IRQ 
the PIC is currently servicing. Multiple 
hardware devices can request inter¬ 
rupts at the same time (so multiple 
bits in the IRR can be on), but since 
the PIC dispatches interrupts (by calling 
the corresponding software interrupt 
handler) sequentially (the highest priority first), only one 
bit will be on in the ISR at any given time. The Interrupt 
Mask Register (IMR) lets you enable or disable particular 
IRQs - each bit in the IMR corresponds to an IRQ level. 

To determine the IRQ level of a UART, then, it is only 
necessary to perform the usual kind of setup involving the 
Interrupt Mask Register (IMR), interrupt vectors, and UART 
initialization, set up a precautionary timer interval (to 
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make sure you don't wait forever for 
an interrupt that never comes), and 
generate an interrupt. The interrupt 
handler then needs only to read the 
ISR and IRR of the PIC to determine 
all possible interrupt occurrences. The 
two exceptions, no interrupts or more 
than one interrupt, indicate a faulty 
UART, an incorrect jumper setting, or 
an interrupt conflict. The function 
uart_irq() in uartjrq.c (Listing 3) 
contains code for this process. 

A little background on program¬ 
ming the PIC will clarify its workings. 
The PIC accepts two types of com¬ 
mand words from the CPU: Initializa¬ 
tion Command Words (ICWs) and Op¬ 
eration Command Words (OCWs). 
ICWs bring the PIC to its starting 
point before normal operation can 
begin. There are four ICWs. They es¬ 
tablish various modes such as level 
versus edge interrupt, single versus 
multiple PICs in the system, and 
whether automatic end-of-interrupt is 
programmed. In a PC, ICW1 is ac¬ 
cessed through I/O port address 0x20 


and ICWs 2, 3, and 4 are accessed 
through I/O port address 0x21. Initiali¬ 
zation is done by the BIOS during 
boot-up and, unless you want a non¬ 
standard mode, need not be re-done. 

There are three OCWs. They com¬ 
mand the PIC to operate in four 
modes: fully nested, rotating priority, 
special mask, and polled. The OCWs 
can be written into the PIC any time 
after initialization. In a PC, OCW1 is 
accessed through I/O port address 
0x21, while OCWs 2 and 3 are ac¬ 
cessed through I/O port address 0x20. 
OCW1 would be familiar to many 
DOS programmers as the operation 
to set or clear bits in the IMR. OCW2 
is used for a variety of useful opera¬ 
tions, the most commonly known be¬ 
ing the End Of Interrupt (EOI) com¬ 
mand; another permits the program 
to alter the interrupt priorities (so 
that, for example, IRQ4 would be the 
highest priority, rather than IRQO). 

Likewise, OCW3 performs a variety 
of commands, including the read regis¬ 
ter commands. The constant identifier 
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<$#include <ddeml.h> 

H D D E DAT A D d e Cl i e ntT ransaction( fpvOata cbData hConv, hszftem. 

uFmt uType. u Timeout /puResuft ) 

void FAR* fpvData' 

DWORD cbData' 

HCONV hConv; 

HSZ hszftem; 

UINT uFmt 
UINT uType; 

DWORD uTfmeout 
DWORD FAR* /puResuft 


Annotation; 


T length of data 
/* handle of conversation 
T handle of item-name string 
f“ clipboard data format 
T transaction type 
T timeout duration 
T points to transaction result 


The documentation does not say so. but the cbData argument 
(length of data) must include the NULL byte if the data is a string. 
In other words, if IpvData is a string. cbData must be set to 
strlen(lpvData)+1. Otherwise, bad things may happen in DDEML 
when you perform an XTYP_POKE or XTYP_EXECUTE 
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Listing 5 

UART definitions and declarations 




// 

uart.h 

- include file for uart utility functions 

//define 

PIC A1 

0x21 // A1 address line 

// 

INS8250-B and compatible UARTs 

//define 

PIC IRR 

0x0a // prepare to read pic IRR 

//define 

TRB 

0 

// transmit and receive buffer 

//define 

PIC ISR 

0x0b // prepare to read pic ISR 

//define 

IER 

1 

// interrupt enable register 

//define 

PIC EOI 

0x20 // end of interrupt command 

//define 

HR 

2 

// interrupt 10 register 

// 

other constant identifiers 4 macros 

//define 

FCR 

2 

// FIFO control register 

//define 

TICKS 

0x0000046c// 0000:046c BIOS tick counter 

//define 

MCR 

4 

// modem control register 

//define 

!0_DELAY 

_asm {jmp short $+2} 

//define 

ISR 

5 

// line status register 

// function prototypes for uart_ utility functions 

//define 

MSR 

6 

// modem status register 

unsigned uart_check 

(unsigned addr); 

#define 

SCR 

7 

// scratch register 

unsigned uart_type 

(unsigned addr); 

//define 

MCR 0UT2 0x08 

// enable UART interrupts via MCR 

unsigned char uart 

irq (unsigned addr); 

// 

8259A programmable interrupt controller 

/* End of File */ 


//define 

PIC_A0 

0x20 

// A0 address line 
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PICJRR, used in the interrupt handler 
comon_isr() within uartJrqO, con¬ 
tains the bit configuration that is in¬ 
terpreted by the PIC as an OWC3 
command to transfer the contents of 
the IRR on the next RD pulse (through 
I/O port address 0x20). PICJSR functions 
similarly, but for the ISR. 

This technique for identifying the 
IRQ of a UART should work for any 
device. You merely do something to 
generate an interrupt and then read 
the IRR and ISR of the PIC. 

Putting It All Together 

The source for magic.exe is in 
magic.c (Listing 4). uart.h (Listing 5) 
contains various constant definitions 
and declarations. The code searches 
the entire AT I/O address space, from 
0x0100 through 0X03FF, for UARTs. It 
outputs the I/O address, designation, 
and IRQ level for each. A value of -7 
for the IRQ indicates a faulty UART, 
an incorrect jumper setting, or an in¬ 
terrupt conflict. It would be useful to 
modify this program to output the list 
of all IRQs when more than one oc¬ 
cur (currently it just indicates multiple 
IRQs with a -7), and also to detect se¬ 
rial ports at the six addresses outside 
of the AT I/O address space allocated 
for serial ports in IBM PS/2 comput¬ 
ers. INT 15h/0c0h can be used to de¬ 
termine if a machine is a PS/2. The 
addresses outside the AT I/O address 
space are 0x3220, 0x3228, 0x4220, 

0x4228, 0x5220, and 0x5228. 

I have used this program with 
great success many times over the 
years, with eight-port serial cards, 
network cards, modem cards, and 
other serial cards for which I had no 
documentation. Please try out some 
UART magic for yourself and let me 
know your results. □ 
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Precompiled Headers: 
Friend or Foe? 

Mark Nelson 


Back in my Wonder Years, poking sticks into anthills or letting a mouse 
loose in class was a reliable way to provoke some entertaining confusion. To¬ 
day I've found a more socially acceptable way to simulate an angry swarm of 
hornets: just put a team of programmers in a room and tell them to decide 
whether or not to use precompiled headers in their current project. 

Precompiled headers are available as an option for most PC-based C++ 
compilers. But there doesn't seem to be anything approaching universal agree¬ 
ment on whether they are a useful feature or simply a marketing gimmick. I've 
heard programmers swear their compile times increased by 50 percent when 
they used precompiled headers, while other (presumably sane) users insist their 
compilations run three times faster. Where does the truth lie? 

The truth is a little more complicated than we might like. Precompiled head¬ 
ers can dramatically speed up your compile times. Likewise, they can make 
your compiler act as if it were keeping its swap file on a floppy disk. Like other 
tools, precompiled headers can do a lot of good, but only when you use them 
correctly. 

Why Precompiled Headers? 

The concept behind precompiled headers is simple. A typical source file for 
a given project might start off with the following list of preprocessor com¬ 
mands: 

//define STRICT 
//include <windows.h> 

//include <stdio.h> 

//include <$tddef.h> 

//include "commlib.h" 

//include "mydata.h" 

class foo { 


Normally, the compiler has to chew its way through all the header files in¬ 
cluded here, comprising thousands of lines of code and preprocessor directives. 
Every time you compile this file, the process has to be repeated. If you were 
looking for ways to speed up the compiler, you might well decide that this area 
could be streamlined. Precompiled headers are an attempt to do just that. 


Mark Nelson is a programmer for Greenleaf Software and a student at the University of 
Texas at Dallas. Mark is the author of The Data Compression Book and Serial Com¬ 
munications: A C++ Developer's Guide, both from MBT Books. You can reach Mark 
on CompuServe at 73650,312. 


April 1995 


Windows/DOS Developer’s Journal — Page 41 

































































The idea here is to capture the internal state of the 
compiler after it has processed all of the unchanged part 
of the file, in the example shown above, the compiler 
might save the internal representation of its symbol table, 
macro definitions, class definitions, and so on, up through 
the last //include statement. 

If this information were stored in an easy to digest for¬ 
mat, the compiler could skip all of the //include statements 
the next time it was asked to compile this file. Instead of 
reading all of the include files, it would just read in the 
state file. 

The state file generated by this process is called a "pre¬ 
compiled header file." The name isn't quite accurate, be¬ 
cause the contents of the state file don't necessarily in¬ 
clude just a single header file, but the name has proven 
useful enough to stick. 

Precompiled header files burst on the DOS/Windows 
world a few years ago. In typical virus-like feature fashion, 
they then quickly spread to include product offerings from 
Microsoft, Borland, Symantec, and Watcom. 

How to Use Precompiled Headers 

Using precompiled headers is a two-step process. The 
first step is necessarily that of generating the precompiled 
header file. The second step consists of using that file in 
subsequent compilations. 

In the dawn age of precompiled header files, creating 
the file was a manual process. You compiled your source 
file with a special switch thrown, to indicate that you 
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wanted to create a precompiled header file. The next time 
you compiled the source file, you used a different switch. 
For example, you could create a precompiled header file 
using Visual C++ using a command line like this: 

cl /Yc foo.cpp 

The He switch tells the compiler to generate a file called 
msvc.pch. To use the .pch file, you then compile again with 
a different command-line switch: 

cl /Yu foo.cpp 

One-Upmanship 

Microsoft's method of generating and using precom¬ 
piled header files had promise, but it suffered from a cou¬ 
ple of major drawbacks. 

First, it wasn't automatic. You had to manually create 
the header file, then change gears to start using it. This 
didn't make a good fit with most programmers' edit/com¬ 
pile/test cycle. 

Second, if you rewrote code in a header file, modified 
# defines, or made some other change in your environ¬ 
ment, the precompiled header file might become invalid. 
Flowever, you might not be aware of this until the com¬ 
piler flagged the problem. Under some circumstances, 
even the compiler might not notice the problem. 

The solution to both problems was to automate the 
process. All four compilers now offer a switch that will 
automatically generate a new precompiled header file 
every time the environment changes, and use an existing 
header file whenever possible. This means that you can 
compile your Microsoft program with the /YX switch, re¬ 
gardless of whether you just modified a few statements in 
my data. h. 

When in automatic mode, the compiler always checks 
the current environment against the environment used to 
create the precompiled header. If the two environments 
match, the existing header file is used. If not, the header 
file is regenerated for use the next time around. 

The compiler has to check a fairly long list of items to 
ensure that the precompiled header is valid in the current 
environment. These items include: 

• Header file timestamps 

• Order of inclusion of header files 

• Memory model 

• Command-line macro definitions 

• Target (DOS/Windows) 

• Calling conventions 

• Language (C or C++) 

The automated process is clearly easier to use, and un¬ 
der the proper circumstances, it is every bit as efficient as 
the manual operation. The compiler switches to turn on 
automatic use of precompiled headers are: 


Microsoft Visual C++ 1 .X and 2.0 /YX 

Borland C++ 4.X -H 

Symantec C++ 6.X/7.0 -HX 

Watcom C++ 10.C /fh 
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Writing the State File 

The compiler switches shown above tell the compiler to 
create precompiled header files when necessary. As I ex¬ 
plained earlier, the compiler will process include files, and 
write out its internal state at some intermediate point in 
the compile. But when exactly will the compiler do this? 
After all of the header files have been read in? When it 
hits the first line of "real code?" How will it know? 

The four different compiler companies have three dif¬ 
ferent solutions to this problem. Borland and Microsoft 
each make use of the hdrstop pragma to tell the compiler 
when to save its state. As soon as the compiler sees that 
pragma in the base file, it should either read or write the 
current compiler state. A typical use of this pragma might 
look like this: 

Me fine STRICT 
//include <windows.h> 

//include <stdio.h> 

//include <stddef.h> 

//include "comnilib.h" 

//pragma hdrstop 
//include "mydata.h" 

class foo { 


Symantec uses a slightly different termination protocol 
with its precompiled headers. It simply continues with pre¬ 
compilation until it encounters the first line in the base file 
that isn't a comment or include directive. So with Syman¬ 
tec, the previous code example might change to this: 

//include <windows.h> 

//include <stdio.h> 

//include <stddef.h> 

//include "commlib.h” 

//define END_0F_PREC0MPILED_HEADERS 
//include "mydata.h" 

class foo { 


Watcom uses yet another approach, which is to pre¬ 
compile only the first header file. To take advantage of 
this approach, you might modify your main module to 
look like this: 

//include "myproj.h" 

//include "mydata.h" 

class foo { 

II .. . 


You would then create a copy of myproj.h that looks like 
this: 

//define STRICT 
//include <windows.h> 

//include <stdio.h> 

//include <stddef.h> 

//include "commlib.h" 

Some Problems 

So far, everything about precompiled headers sounds 
sensible, maybe even wonderful. What could possibly go 
wrong? 

There are several ways that your project can actually 
be hindered by precompiled headers. Problems that I have 
personally encountered include: 

• All that work for nothing 

• Excessive regeneration 

• Borland's disk sponge 

"All that work for nothing" is a scenario that many peo¬ 
ple when they first test the utility of precompiled headers. 
This usually occurs when you are testing a program of 
short to medium length that resides in a single source file. 

Realize that the compiler pass when you first create the 
precompiled header will actually take longer than it would 
if you weren't using precompiled headers. This makes 
sense, because the compiler has to stop in midstream and 
dump much of its internal state to a file. This is work that 
it wouldn't have to do otherwise, and it takes time. 

So when your project consists of a single source file, 
you actually have no use for a precompiled header file. If 
you are compiling five or six files sequentially, every file 
after the first one could use the stored state file, but with 
just one file, you lose that advantage. Subsequent com¬ 
piles of the main file will of course be able to take advan¬ 
tage of the header file, but only on passes when you 
don't have to regenerate it. 

"Excessive regeneration" occurs when you keep regener¬ 
ating your header file, instead of using the one created 
previously. The most likely cause of this is having different 
sequences of include files in each of your source modules. 
Remember that the compiler usually insists on the same 
header files being included in the same order if it is to 
take advantage of the precompiled header file, if every 
source file includes header files in a different order, you 
will end up generating a new header file on every com¬ 
pile, resulting in an overall decrease in speed. 

"Borland's disk sponge" is a phenomenon unique to Bor¬ 
land. Borland's compiler is smarter than that of its com¬ 
petitors. It can store multiple configurations in a precom¬ 
piled header file. This means that even if you have differ¬ 
ent include file ordering in different files, each can have its 
own unique state stored in the precompiled header file. 

I thought this was a really great idea, until I tried com¬ 
piling a fairly sloppy (at least by precompiled header 
standards) project. Despite having plenty of space to work 
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Table 1 Compiler benchmarks of precompiled 

header effectiveness 

Vendor 

Command line 

Total Time 

Borland 

bcc -c -ml -WS -l..\h -H=al.csm 
bcc -c -ml -WS -I.Ah 

34 

1:08 

Symantec 

sc -c -ml -W1 -I.Ah -HX 
sc -c -ml -W1 -I.Ah 

44 

1:32 

Microsoft 

Cl /C /AL /G2 /GA /I.Ah /YX 

Cl /C /AL /G2 /GA /I.Ah 

1:12 

2:43 

Watcom 

wd /ml /c /i=..\h 
/bt=windows /fh 
wcl /ml /c /i=..\h /bt=windows 

1:45 

3:41 


with, I started getting 'disk full' messages from the com¬ 
piler. Imagine my surprise when I saw my al.csm precom¬ 
piled header file taking up 25 Mb of disk space! 

Using Precompiled Headers Effectively 

Making precompiled headers work for you takes a bit 
of planning. To maximize your gains, you need to avoid 
the traps I just discussed. This requires just a few careful 
steps. 

First, make sure your project is an appropriate candi¬ 
date for precompiled headers. If you have only a couple 
of source modules, with lots of code but not too many 
header files, you might want to pass up the idea com¬ 
pletely. 

Second, if your project is appropriate, identify the set of 
relatively static header files that are used throughout. Nor¬ 
mally, files such as windows.h, iostream.h, and stdio.h are 
included in many, if not all, of your source files. Take all 
these files and group them in a single master header file. 
For example, myapp.h might look like this: 

#define STRICT 
//include <windows.h> 

//include <iostream.h> 

//include <iomanip.h> 

//include <fstream.h> 

Be sure to exclude header files that change constantly. 
An obvious example of this would be header files used by 
your resource editor. Every time you run AppStudio or Re¬ 
source Workshop, you are almost guaranteed to change 
the timestamp of your resource header file, even if the 
contents don't change. Including this file in your master 
header list will force frequent regeneration. 

Finally, include the master header file at the top of 
every one of your source files. Be sure to follow the //in¬ 
clude with a line that forces the end of precompiled 
header generation, then follow that with any relatively dy¬ 
namic header file //includes. A generic approach that 
works with all four compilers might look like this: 


II 

II MYFILE.CPP 
// 

// February 30, 1995 
// 

//include "myapp.h" 

//pragma hdrstop 
//define ST0P_PREC0MPILATION 
//include "resource.h" 

//include "data.h" 

These aspects of your project are important, but you 
can also modify your environment to improve perform¬ 
ance. Precompiled header files are typically quite large, up 
to 1Mb, even using the techniques listed above. If you 
have access to a decently large disk cache, you will be 
able to turbocharge your compiler's use of precompiled 
headers. Symantec even recommends that you go so far 
as to force the precompiled header file to a RAM disk. 
Essentially, anything you can do to speed up disk access 
will make precompiled headers more effective. 

Summary and Test Results 

The reason I feel confident when discussing these tech¬ 
niques is that I have spent a fair amount of time actually 
using them. At Greenleaf Software we have been selling C 
and C++ libraries for the past 10 years, and for 10 years 
our customers have fretted about how long it takes to 
rebuild those same libraries. For a long time, I wrote off 
this concern as typical programmer crankiness. 

This year, to my chagrin, I developed a strong personal 
interest in compile times. While working on my most re¬ 
cent product, Greenleaf CommLib, I realized that I had a 
major bottleneck on my hands. A complete build of 
CommLib across seven compilers and countless memory 
models had grown to the point where it took over 24 
hours to complete! As the release date for CommLib ap¬ 
proached, I saw that I might be able to get more sleep if I 
didn't have to stay up all night baby-sitting compilers. 

After using the techniques describe here, I was able to 
cut my compile times in half. A product like CommLib is 
ideally suited to use precompiled headers, as it contains 
lots of small source modules and has quite a few header 
files. But I feel that my gains are representative of the 
improvements you should be able to realize on some of 
your own projects. 

Table 1 shows the results of a compilation of a subset 
of files in my current project, Greenleaf ArchiveLib. Times 
are shown both with and without precompiled headers. 
For all four compilers I was able to see compile times cut 
roughly in half. 

Precompiled headers aren't right for everybody or 
every project. But with some simple planning, I found that 
they were able to help me get a decent night's sleep. Give 
them a try, and maybe you too can lose those bags under 
your eyes! □ 
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Updating the Status Bar in Popup Menus 


V. Ramachandran 
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Updating the status bar with a one-line help message whenever the user is 
scrolling through the menu bar has become commonplace in Windows-based 
applications. Windows sends UM_MENUSELECT messages with the menuitem id in 
the wParam to the window whenever the user scrolls through the menu. This is a 
good time for the application to get the help string associated with the 
menuitem id and display it in the status bar. However, this will not work for 
popup menus (like File, Edit, etc.), since popups do not have a menu id. But as 
you may have noticed, applications like Microsoft Word do update the status 
bar - even when the File or Edit popup is highlighted. 

The idea is to use the hlM__MENUSELECT message to identify which popup is 
currently highlighted. If the application knows the selected popup, it can then 
display an appropriate message. I present here two solutions to achieve this. 
Note that the WM_MENUSELECT message supplies the following additional informa¬ 
tion: 

wParam - menuitem id, or handle of the popup if a popup is selected. 
LOWORD (IParam) - menu flags; if it is MF_POPUP, then wParam contains a menu 

handle. 

HIWORD (IParam) - handle of the menu. 

The code disk (see table of contents for availabiliity) contains sample code 
that is a modification of the generic application that ships with the Windows 
3.1 SDK. Figure 1 shows the relevant pieces of code that demonstrate the two 
different techniques I will describe. The status bar I use is the one that comes 
with comnctrl.dll, which ships with Windows for Workgroups. However, its us¬ 
age is incidental; any status bar will do. For purposes of this article, the steps 
involved in the creation of the status bar are: 

Include COMMCTRL.H. 

Linkwith COMMCTRL. LIB (COMMCTRL.DLL should be accessible). 

Create the status bar with a call to CreateStatusWindowO. The prototype is as fol¬ 
lows: 

HWND CreateStatusWindow (DWORD dwStyle, LPSTR szText, HWND hWndParent, UINT nID); 

Setting text in the status bar entails sending a SB_SETTEXT message with the 
IParam pointing to a null-terminated string. In the sample, this is done with a 
call to SetStatusBarTextO. 



Leor Zolman is a consultant specializing in C programming training, an instructor on 
UNIX topics for Boston University's Center for Information Technology, and "Tech Tips" 
editor for Windows/DOS Developer's Journal. His book, Illustrated C, was publish¬ 
ed in 1992. He may be contacted at 74 Marblehead St, North Reading, MA 01864. 
Internet address: leor@bdsoft.com 



















The UM_MENUSELECT message is trapped in MainklndProcO 
and the handler calls HandleMenuSelectO. HandleMenuSelect 
then checks to see whether: 

A menu is being closed. 

The system menu is being used. 


A menu item is currently selected. 

A Popup menu is currently selected. 

Special action is taken only when a popup menu is cur¬ 
rently selected. You can call either HandlePopupMenuslO or 


Figure 1 Window procedure that calls HandleMenuSelectO 


/* Window proc that calls HandleMenuSelectO *1 

long FAR PASCAL MainWndProctHWND hWnd. UINT message. 

WPARAM wParam, LPARAM lParam) 

{ 

switch (message) { 
case WM.MENUSELECT: 

if (HandleMenuSelect (hWnd. message. 

wParam. lParam)) 
return DefWindowProc (hWnd. message. wParam, 

lParam); 


* processing is required, FALSE otherwise. 

* Comments: HandlePopupMenusl and HandlePopupMenus2 are 

* two possible ways to handle display of status 

* bar messages for popup menus. 

*********************************************************** j 


int HandleMenuSelect (HWND hWnd, UINT message, 

WPARAM wParam, LPARAM lParam) 


WORD wHelpContextID; 


break; 

case WM_DESTROY: 

PostQuitMessage(0): 
break; 
default: 

return DefWindowProc (hWnd, message, wParam. 

lParam); 

} 

return FALSE; 


// -1 means menu is being closed 
if ((LOWORD (lParam) == -1) U (HIWORD (lParam) == 0)) { 
SetStatusBarText (EMPTYJTRING); 
return TRUE; 

1 

// if system menu 

if (LOWORD (lParam) & MF_SYSM£NU) { 

SetStatusBarText (SYSTEM_MENU); 
return FALSE; 


/********************************************************** 

* Handles updation of the status bar. 

* Calls; SetStatusBarText 0 - to set status bar text. 

* Calls; HandlePopupMenusl 0. See comments below. 

* Returns; TRUE if a menu is being closed, and default 
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if (LOWORD (lParam) & MF_POPUP) { 
wHelpContextID = HandlePopupMenusl 

// wHelpContextlD = HandlePopupMenus2 
// 

} 


// Popup menu. 
(hWnd, message. 
wParam, lParam); 
(hWnd, message. 
wParam, lParam); 


else { // Normal menu item, 

if (LOWORD (lParam) S MF_SEPARATOR) 
SetStatusBarText (EMPTYJTRING): 
else ( 

wHelpContextID = wParam; 
SetStatusBarText (wHelpContextlD); 

} 

) 

return FALSE: 

} 


I*********************************************************** 


* HandlePopupMenusl 

* Parameters: Same parameters as any Window Procedure. 

* Returns FALSE if it processed the message. 

* Description: 

* This uses the handle that comes as the wParam in the 

* WM_MENUSELECT message and uses it to get the first 

* menuitem under that popup. Compare the id with the 

* list of ids that form the first menu item under a 

* popup to get a handle on the popup that the user is 

* currently at. 

* Note: 

* This function will need changes if your application 

* removes or changes the first menu items of popups at 

* run-time. The modification will involve more items 

* to check for. However, this function will work for 

* popups at any levels. 


********************************************************** I 


int HandlePopupMenusl (HWND hWnd, UINT message, 

WPARAM wParam, LPARAM lParam) 


WORD wHelpContextlD = 0; 

HMENU hSubMenu = (HMENU)wParam; 

int nMenuID ■ GetMenuItemID (hSubMenu, 0); 

switch (nMenuID) { 
case ID_FILE_NEW: 

wHelpContextlD = ID_FILE_POPUP; 
break; 

case ID_ED1TJND0: 

wHelpContextlD = IDJDIT.POPUP; 
break; 
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HandlePopupMenus2() to handle the updating of status bar 
popups. Calling both is overkill. 


Solution 1: 

Use the first menuitem in each of the popups as the 
indicator. In the example, in the File popup menu, the first 
menuitem is File \ New (ID: ID_FILE_NEW). In the Edit popup 


Figure 1 continued 


case ID_VIEW_T00LBAR: 

wHelpContextlD = ID_VIEW_POPUP; 
break; 

case IDJIINDOWJEW: 

WHelpContextlD = IDJIINDOtLPOPUP; 
break: 

case ID_HELP_AB0UT: 

wHelpContextlD = ID_HELP_POPUP; 
break: 

// .... 

// Add more case statements here whenever you add 

// more popups to the menu. 

default: 

// Should never come here. 

WHelpContextlD = EMPTY_STRINfi; 
break: 

} 

SetStatusBarText (wHelpContextlD): 
return FALSE: 

} 

j *********************************************************** 

* HandlePopupMenus2 

* Parameters: Same parameters as any Window Procedure. 

* Returns FALSE if it processed the message. 

* Description: 

* This will work only if your application has top-level 

* popups only. This runs through the list of top-level menus 


* and gets the appropriate id. I have chosen IDs which 

* correspond to the position of the popups to save another 

* check. This is not necessary. 

* Note: 

* As mentioned above, this will not work if your menu 

* has popups other than the top level ones. However, if it 

* does not have, this method is advantageous since it does 

* not involve adding more case statements and the like that 

* have to be done in the previous step. 

ft********************************************************** j 

int HandlePopupMenus2 (HWND hWnd, UINT message. 

WPARAM wParam, LPARAM IParam) 

{ 

HMENU hSubMenu = (HMENU)wParam; 

HMENU hMenu = (HMENU) HIWORD (IParam); 

// Get number of popups 

int nMenuItemCount - GetMenuItemCount (hMenu); 
int i; 

for (i = 0; i < nMenuItemCount; i++) 
if (GetSubMenu (hMenu, i) == hSubMenu) 
break; 

SetStatusBarText (i); 
return FALSE; 


/* End of File */ 
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menu, the first menuitem is Edit \ Undo (ID: ID_EDIT_UNDO). 
Knowing the first menuitem id gives you a handle on 
which popup is currently highlighted. So, switch on the 
first menuitem id and display the appropriate message in 
the status bar. 

Solution 1 will not work if you change the menuitems 
at runtime. If you do add or remove menuitems, you will 
also need to add more case statements to check for the 
appropriate menuitem, depending on which is the first 
menuitem. Similarly, if you add more popups, then you 


will have to add more case statements. However, this so¬ 
lution can be used for popups at any level. 

Solution 2: 

Get each popup menu handle that the window menu 
has and check whether the wParam parameter matches any 
of them. If so, use the zero-based index of the popup 
menu to determine which popup has been selected. 

This will work for top-level popups only. However, if 
your application does not have popups other than at the 
top-level, this method is preferable, 
as you do not have to remember to 
add more case statements if you add 
top-level popup menus or if your ap¬ 
plication changes the first menuitem 
of the various popups. 
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James K. Lawless 
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I often use Internet electronic mail 
to send programs or other types of 
binary files to other people. Since the 
mail items can only reliably contain 
ASCII text, binary data must be en¬ 
coded into a text form before being 
inserted into the mail message. 

One method of accomplishing this 
is to use MS-DOS ports of two UNIX 
utilities, uuencode and uudecode. uuen- 
code is used to translate a binary file 
into an encoded ASCII text form. 
uudecode is the counterpart utility that 
will reconstruct the binary file from 
the encoded text. 

I often find myself needing to send 
binary files via Internet mail to people 
who don’t have uudecode. There are 
several utilities which will translate a 
binary file into a special text file to be 
used as an input script for the MS-DOS 
DEBUG utility. This text file comprises 
debug commands to name the file, to 
enter the data as a series of hexadeci¬ 
mal numbers (separated by spaces), 
and to write the output file. 

While this does work, it is often 
less than practical. Using two charac¬ 
ters and a space character to repre¬ 
sent a single byte can nearly triple 
the amount of data that gets sent as 
text. 
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As a solution to this dilemma, I've created a method by 
which the best features of both tools (uuencode and DEBUG) 
can be used. 

The programs that use DEBUG to translate a hex dump 
back to a binary file do not fully exploit the potential of 
this powerful MS-DOS tool. DEBUG is capable of executing 
machine code. This means that it should be possible to 
create a short machine-code routine that could read and 


translate the remainder of the input into any form you 
choose! 

The goal of my machine-code routine is to read the 
data from the standard console input device and recon¬ 
struct the binary data that it represents into DEBUG'S tran¬ 
sient program workspace at I00h. The machine-code rou¬ 
tine should execute in a high portion in memory so that it 
does not conflict with data in the work buffer. After the data 
is decoded, the machine-code routine should terminate, 


Listing 1 dbencode.c 


// Jim Lawless 

// 74217.531@compuserve.com 

// 

// This program will create a script for the MS-DOS 
// DEBUG utility that will provide functionality 
// similar to the Unix UUDECODE program. 

// 

// Syntax: 

// DBENCODE <input-binary-fi1e> <output-text-script> 

// 

// Compile: 

// bcc dbencode.c 

// 


// Now read file and translate groups of 
// characters. 

whi1e(count=(fread(inbuf.1.3.fin))) { 
outbuf [0]=( i nbuf [0]»2)+0x21; 
outbuf[l]=( (inbuf [0]&3)«4)+(inbuf[l]»4)+0x21; 
outbuf [2]=( (inbuf [l]&0x0f )«2)+(i nbuf [2]»6)+0x21; 
outbuf[3]=(inbuf[2]&0x3f)+0x21: 
write_codes(); 
total+=count; 

} 

// Write clean-up text to script 
epilogueO; 


♦include <stdio.h> 
♦include <stdlib.h> 


// Close files 
fclose(fin); 
fclose(fout); 


void prologue(void); 
void epilogue(void); 
void write_codes(void); 


// Input and output files 
FILE *fin.*fout; 

unsigned count,total=0: 
unsigned char inbuf[3]; 
unsigned char outbuf[4]; 

// 70 characters-per-line 
int cpl=70: 

// Running count of the number of characters 
// that have been output 
int chars_out=0; 

// Global reference to the input filename 
char ‘name; 


♦define EOI (0x40+0x21+1) 
void mainCint argc.char “argv) 

{ 

ifLarge < 3) { 
fprintf(stderr, 

"Usage: dbencode input-file output-file"); 
exit(l); 

} 

if((fin=fopen(argv[l],"rb"))==NULL) { 
fprintfCstderr, 

"Cannot open input file %s\n",argv[l]); 
exit(l); 

} 

if((fout*fopen(argv[2],"w"))**NULL) { 
fprintf(stderr, 

"Cannot open output file %s\n",argv[2]); 
exit(l); 


// Provide global reference to input filename 
name=a rgv[l]; 

( 

// Write out initial stuff to script file 
prologueO; 


exit(0); 
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Listing 1 continued 


void prologue(void) 
{ 


// Write out lines that will cause DEBUG to 
// place the assembly code at F000 ( F008 
// is the actual execution point ). 

// When executed, this little program will 
// decode the remainder of the text into 
// DEBUG’S work buffer. 

fprintf(fout,"e F000 44 F0 4B F0 5D F0 6F F0” 
” 0E IF 33 DB BF 00 01 B4\n”); 
fprintf(fout,"e.F010 0A BA 75 F0 CD 21 A0 77" 
" F0 3C 62 74 18 8A 0E 76\n”); 
fprintf(fout,"e F020 F0 32 ED BE 77 F0 8A 04" 
" 3C 62 74 E3 E8 07 00 49\n”); 
fprintf(fout,"e F030 E3 DD 46 EB FI C3 51 2C" 
" 21 FF 97 00 F0 59 43 43\n"): 
fprintf(fout,"e F040 83 E3 07 C3 D0 E0 D0 E0" 
" 88 05 C3 8A E0 B1 04 D2\n”); 
fprintf(fout,”e F050 E8 08 05 8A C4 47 B1 04" 
" D2 E0 88 05 C3 8A E0 Bl\n"); 
fprintf(fout,”e F060 02 D2 E8 08 05 47 B1 06" 
" 8A C4 D2 E0 88 05 C3 24\n"); 
fprintf(fout,"e F070 3F 08 05 47 C3 5A\n"); 

// Change IP register to F008 
fprintf(fout."rip\n”): 
fprintf(fout."f008\n"): 

// Execute assembly code 
fprintf(fout,"g\n"); 


void epilogue(void) 

{ 

// If the current line is not terminated 
// with my special end-of-input character, 
// do so, now. 
if(chars_out) 

fprintf(fout,"%c\n”. EOI); 

// Write end-of-input character as first 
// character in line to indicate the end. 
fpri ntf(fout, ")!c\n", EOI); 

// Assembly code will now have halted, 

// returning us to DEBUG. 

// Tell DEBUG how much info we want to 
// write. 

fprintf(fout,"rcx\n"); 
fpri ntf (fout, ")!x\n", total): 

// Tell DEBUG the name of our output file 
fprintf(fout,"n i!s\n",name); 

// Tell DEBUG to write the output file 
fprintf(fout,"w\n"); 

// Finally, tell DEBUG to quit, 
fprintf(fout,”q\n"); 


// Write out each code. 4 bytes are 
// always output. If extraneous bytes 
// are written, an attempt to decode 
// them will not be made, 
void write_codes(void) 

{ 

int i; 

for(i=0:i<4:i++) { 

fprintf(fout,”Jc",outbuf[1])i 

chars_out++; 

if(chars_out>=(cpl-1)) { 
fprintf(fout,"Jc\n",EOI); 
chars_out=0; 


} 

} 

/* End of File */ 


leaving DEBUG in control. At this point, the script should 
contain DEBUG commands to name and store the de¬ 
coded data. 

This does not solve the problem of finding an efficient 
way of storing the binary data. What's needed is a 
method that facilitates both a minimal growth impact on 
the data and a minimal machine-code driver for DEBUG. 

A particularly attractive feature of uuencode is that it en¬ 
codes data in such a manner that a minimal data loss 
occurs. My equivalent to uuencode (dbencode.c, Listing 1) 
translates three input bytes into four (a 25 percent in¬ 
crease). It sections the three input bytes into four groups 
of six bits, then takes the number represented by each 
six-bit code and adds 0x21 to it (0x20 is an ASCII space). 
This translates each six-bit code into a standard ASCII 
character. At the end of each line, dbencode.c places an 
end-of-input (EOI) character as a line-terminator. The spe¬ 
cial character I use is a lower-case "b". When the input 
data has been exhausted, the decoder encounters the EOI 
character as the first character of the line. 

The prologueO function in dbencode.c writes the follow¬ 
ing to the output text file: 


e 

F000 

44 

F0 

4B 

F0 

5D 

F0 6F 

F0 

0E 

IF 

33 

DB 

BF 

00 

01 

B4 

e 

F010 

0A 

BA 

75 

F0 

CD 

21 A0 

77 

F0 

3C 

62 

74 

18 

8A 

0E 

76 

e 

F020 

F0 

32 

ED 

BE 

77 

F0 8A 

04 

3C 

62 

74 

E3 

E8 

07 

00 

49 

e 

F030 

E3 

DD 

46 

EB 

FI 

C3 51 

2C 

21 

FF 

97 

00 

F0 

59 

43 

43 

e 

F040 

83 

E3 

07 

C3 

D0 

E0 D0 

E0 

88 

05 

C3 

8A 

E0 

B1 

04 

D2 

e 

F050 

E8 

08 

05 

8A 

C4 

47 B1 

04 

D2 

E0 

88 

05 

C3 

8A 

E0 

B1 

e 

F060 

02 

D2 

E8 

08 

05 

47 B1 

06 

8A 

C4 

D2 

E0 

88 

05 

C3 

24 

e 

F070 

3F 

08 

05 

47 

C3 

5A 











rip 
f 008 
9 


This section of the script creates a machine-code program 
that is to be launched from address F008. The next few 
lines cause the machine-code to be activated. (See dbde- 
code.asm (Listing 2) for a breakdown of the machine-code.) 

At this point, the encoded data is written to the script 
file. When the encoded data is complete, the function epi- 
logueO writes the following to the output script: 

rex 

<a hex code for the size of the data will be here> 
n <file name> 
w 

q 

These lines cause the data buffer to be written to a speci¬ 
fied file name, given a specified size. The "q" instruction 
terminates the DEBUG session. 

To use this process, the receiver of the mail message 
must be instructed to separate the DEBUG script from the 
mail message and perform an action similar to the follow¬ 
ing: 

DEBUG < SCRIPT.TXT 


Page 52 — Windows/DOS Developer’s Journal 


April 1995 











The output file will then be constructed in the user's cur¬ 
rent directory. 

I now use this method regularly when sending binary 
data to recipients who are known to have MS-DOS. There 
are a couple of limitations, however, that are worth men- 


EXE extension. The second is that DBENCODE is limited to 
about 60Kb of data (the machine code program sits just 
above the buffer). I recommend using an archiving tool to 
package all of your data before using the DBENCODE util¬ 
ity. This will usually give you the added assurance of a 


tioning. The first is that DEBUG cannot write a file with an 

CRC-based integrity check by the archiving tool. 

Listing 2 dbdecode.asm 


; The purpose of this program is simply to 

jz nextline 

; assemble some code at address F000h. The 


; executable code needs to live at this 

; otherwise send the value to the decoder 

; address, leaving the area from 100h 

call sendcode 

; to EFFFh free as an output file buffer. 


code segment 

: decrement counter 

assume cs:code,ds:code 

dec cx 

main proc near 

; if counter is zero, read the next line 

org 0100h 

jcxz nextline 

begin: 


: This jump is used for debugging purposes 

: bump input buffer pointer 

; only. The code at F000- is extracted and 

inc si 

; has been placed in a DBENCODE.C in a 


; hex-dump form. 

; resume loop 

jmp start 

jmp looper 

; change the origin to F000h 

: we’re done. quit. 

org 0F000h 

done: 

; this address table is used to call a 

ret 

; function depending on the enumerated 


; state of the input. Input will consist of four 

; this subroutine decodes each character. 

; characters. Each function represents how to process 

; reconstructing the input into the output 

: the character for the given state. 

; buffer 

fund i st dw fund 

sendcode proc near 

dw func2 



dw func4 
end-of-input character 
(space-char)+l + our range (64/40h) 


+ 1 


EOI 


equ 


21h+40h+l 


start: 

push cs 

pop ds 

: use BX as an index (0-3) related to the 
; enumerated input state. 

xor bx,bx 

: Use DI to point to output buffer 

mov di.offset 100h 

: read next line from standard input 
: into MS-DOS formatted buffer "buff" 
nextline: 

mov ah.Oah 

mov dx,offset buff 

int 21h 

; is first character an EOI? 

mov al,ds:[buff+2] 

cmp al,EOI 

: if so, we’re done 

jz done 

: get the number of characters read into CX 
mov cl ,ds:[buff+l] 

xor ch.ch 

; point SI to the input buffer 

mov si.offset buff+2 

: loop through all input characters 
looper: 

; get next input character 

mov al,ds: [si ] 

cmp al.EOI 

: if we encounter EOI, read the next line 
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When Jim Lawless submitted a previous Tech Tip to me us¬ 
ing this technique, I asked him to write up his encoding scheme 
as new Tip, and he was kind enough to oblige. I encourage all 
readers submitting Tech Tips via the Internet to first ZIP their 
Tips (including all source files, resource files, documentation and 
Makefiles) and then apply Jim's DBENCODE utility to generate 


the text for the E-mail message. About half the time anyone at¬ 
tempts to send me uuencode-ed material, it doesn't uudecode cor¬ 
rectly under the UNIX system on my end! And, as Jim points out, 
many people don’t have access to either a native UNIX uuencode 
utility or a DOS equivalent. The beauty of Jim’s method is that it 
requires neither, -lx □ 


Listing 2 continued 


; save CX. We’ll need to use it for some 
; shifting operations. 

push cx 

; normalize al to the range (0-3fh) inclusive 
sub al,21h 

: call appropriate function based on value in 
; BX register. 

call ds:[bx+offset funclist] 

; restore CX 

pop cx 

; adjust function pointer BX 
inc bx 

inc bx 

and bx,7 ; constrict to (0,2,4,61 

; return to caller 
ret 

sendcode endp 


ENGINEERING 


Cummins Electronics Is a wholly-owned subsidiary of 
Cummins Engine Company, a leading worldwide designer 
and manufacturer of fuel-efficient diesel engines, 
components and power systems for trucks and industrial 
equipment. As a leading designer and manufacturer of 
electronic systems and related products, Cummins 
Electronics is experiencing extensive growth, resulting in 
excellent career opportunities for the following professionals: 

PC Software Engineer 
Embedded Software Engineer 
Windows Design Engineer 

We are located in Columbus, Indiana, a small growing 
community located within easy driving distance of 
Indianapolis, Louisville and Cincinnati. Columbus is noted 
for its architecture, extensive parks and recreations 
systems and Its excellent quality of life. We offer opportu¬ 
nity for future advancement, competitive salaries, benefits 
and relocation package. For consideration, please 
send your resume, salary requirements and cover letter, 
indicating position of interest to: Cummins Electronics, 
Dept. WDCP, P.O. Box 1024, Columbus, IN 47202. 
Equal Opportunity Employer 




: handle first code 


fund 

proc 

near 


shl 

al,l 


shl 

al ,1 


mov 

ret 

ds:[di],al 

fund 

endp 


: handle 

second code 


func2 

proc 

near 


mov 

ah,al 


mov 

cl ,4 


shr 

al.cl 


or 

ds:[di],al 


mov 

al ,ah 


inc 

di 


mov 

cl,4 


shl 

al ,cl 


mov 

ret 

ds:[di],al 

func2 

endp 


; handle third code 


func3 

proc 

near 


mov 

ah.al 


mov 

cl,2 


shr 

al ,cl 


or 

ds: [di],al 


inc 

di 


mov 

cl.6 


mov 

al ,ah 


shl 

al.cl 


mov 

ret 

ds: [di ] ,al 

func3 

endp 



: handle fourth code 


proc 

near 

and 

al,3fh 

or 

ds:[di].al 

inc 

di 

ret 


endp 



excessively large work buffer. This 
buffer is formatted for DOS function 0ah. 
This function needs to know the maximum 
number of characters allowed for input as 
byte 0. It uses the next byte as the number 
of bytes read. The remainder comprises the 
input record. 


buff 

db 

90 


db 

■> 


db 

90 dup(?) 

main 

endp 


code 

ends 


: End of File 

end 

begin 
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Paul Bonneau 
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1601 W. 23rd St., Suite 200 
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The volume of questions and com¬ 
ments for Paul is now such that he will 
be able to respond only to messages 
he will address in the column. He defi¬ 
nitely wants to hear from you - he 
just may not be able to let you know 
that personally. 



Visual C++ vl.5 
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Q ls it possible to be notified (by mean of hooks or something else) when 
the active window changes? I'm trying to write a program able to know 
the user just opened a particular window (I know the caption I want to moni¬ 
tor) and I hate writing something like this: 

while (TRUE) 

{ 

GetActiveWindow(...) 

GetWindowTextO 
if (is what I look for) 
processjt 
YieldO 
} 

Please note that I want to monitor the entire system, not only my children 
windows. 

L. Croce 
CIS: 100115,3465 

A Windows notifies your program of a wide variety of events it thinks are 
relevant, mostly events that have to do with your program's windows. 
When that is not sufficient, though, Windows also offers a means to specify a 
"hook" function that it will call as part of the overall message stream, giving 
you access to almost every possible event in the system. There are several 
different types of such hooks, depending upon where in the messaging system 
you want to place your hook function. 

The functionality you are looking for is available from the Computer Based 
Training (CBT) window hook. You can install a CBT hook by calling SetUindow- 
sHookExO with the UH_CBT hook type identifier, the address of a CBT hook proce¬ 
dure, the instance handle of the module installing the hook, and in your case, 
since you want system-wide monitoring, NULL for the task handle parameter. A 
CBT hook procedure receives all kinds of handy notifications, but the one of 
interest to you is HCBT__ACTIVATE. Windows delivers this notification each time the 
active window changes. 


Paul was a developer of HyperChem, a molecular modeling system, and more recently, 
of Creative Writer, a word processor for children. He works for Microsoft Corporation as 
a Software Design Engineer. The opinions expressed in this column are Paul's alone 
and not those of Microsoft. 


























Since you are interested in system-wide activation 
changes, your hook procedure may get called in the con¬ 
text of some other application. That means that your 
hook procedure will be executing on the stack of some 


other application, which in turn means that your code will 
be simpler if you place your hook function in a DLL (un¬ 
like EXE functions, DLL functions normally do not as¬ 
sume their stack segment also contains their data 


Listing 1 Using a CBT hook for window activations 


/////////////////////////////////////////////////////// 


// activtrk.c // 
// -- DLL monitors changes in the active window // 
// and notifies client via a registed windows // 
// message. // 
// -- Written by Paul R. Bonneau, 11/26/95. // 


/////////////////////////////////////////////////////// 
//include <windows.h> 

//include "activtrk.h" 

//ifdef_WATCOMC_ 

//pragma off (unreferenced); 

//endif 


HWND hwndClient; 

HHOOK hhok; 

LRESULT CALLBACK_export LwHookProcCint wCode, 

WPARAM wParam, LPARAM 1 Param): 

typedef struct 
{ 

BOOL fMouse; 

HWND hwnd; 

} WAI; // Window Activation Info. 


//ifdef_BORLANDC_ 

//pragma argsused 
//endif //_BORLANDC_ 

int CALLBACK LibHain(HINSTANCE hins, WORD ds, 

WORD cbHeap, LPSTR lsz) 

/////////////////////////////////////////////////////// 
// -- Library entry procedure. Install the CBT // 
// hook. // 

/////////////////////////////////////////////////////// 
{ 

return NULL == (hhok = SetWindowsHookEx(WH_CBT, 

(H00KPR0C)LwHookProc. hins, NULL)) ? 0 : 1; 

} 

//ifdef_BORLANDC_ 

//pragma argsused 
//endif 

int CALLBACK _export WEPtint wExit) 
/////////////////////////////////////////////////////// 
// -- Remove CBT hook. // 

/////////////////////////////////////////////////////// 
( 

if (NULL != hhok) 

{ 

UnhookWindowsHookEx(hhok); 
hhok = NULL; 

} 

return 1; 

} 

BOOL CALLBACK_export FRegisterWndCHWND hwnd) 

/////////////////////////////////////////////////////// 
// -- Install the client’s notification window. // 
// -- hwnd ; Window to receive notifications. // 

/////////////////////////////////////////////////////// 
{ 

if (NULL != hwndClient) 
return FALSE; 

hwndClient = hwnd; 
return TRUE; 

} 

void CALLBACK _export UnregisterWnd(HWND hwnd) 

/////////////////////////////////////////////////////// 
// -- Remove the client's notification window. // 
/////////////////////////////////////////////////////// 
{ 

if (hwnd == hwndClient) 
hwndClient * NULL; 

} 

//ifdef_BORLANDC_ 

//pragma argsused 
//endif 

LRESULT CALLBACK_export LwHookProctint wCode, 

WPARAM wParam, LPARAM 1Param) 
/////////////////////////////////////////////////////// 
// -- CBT hook callback. // 

/////////////////////////////////////////////////////// 
{ 

if (HCBT_ACTIVATE == wCode U IsWindow(hwndClient)) 
SendMessagethwndClient, wmActive, wParam, 
MAKEL0NG(((WAI FAR *)1Param)->hwnd. 0)); 

CallNextHookExthhok, wCode, wParam, 1Param); 
return 0; 

} 

/* End of File */ 
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by Guy Eddon 
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Listing 2 Header file for activtrk.c 


/////////////////////////////////////////////////////// 
// actvtrk2.h // 

// -- Interface to routine that monitors changes in // 
// the active window. // 

// -- Written by Paul R. Bonneau, 11/26/95. // 

/////////////////////////////////////////////////////// 
// Routines to allow client to register and unregister 
// itself with the DLL. 

BOOL CALLBACK export FRegisterWndCHWND hwnd); 

void CALLBACK export UnregisterWndCHWND hwnd); 

//define wmActive WMJJSER 
/* End of File */ 


segment). activtrk.c (Listing 1) is the source for a DLL that 
contains a CBT hook procedure. The DLL calls SetUindow- 
sHookExO during processing of its LibMainO entry point, to 
install the hook function LuHookProcO. The DLL's WEP pro¬ 
cedure (called by Windows when the DLL unloads) re¬ 
moves the hook function. The hook function itself notifies 
its client application of an activation change by sending it 
a private, user-defined message. Before using the DLL, the 
client must first call the exported function FRegi sterklndO, 
to provide a window handle to receive the private mes¬ 
sage. When the client wishes to stop receiving the private 
activation messages, it should call another DLL exported 
function, UnregisterUndf). Whenever the DLL's hook proce¬ 
dure receives an HCBT_ACTIVATE notification and there is a 


Listing 3 Demonstration of CBT hook for window activations 


/////////////////////////////////////////////////////// 

TranslateMessage(imsg); 


// demoactv.c // 

DispatchMessage(Smsg); 


// -- Program uses FRegisterActiveProcO to display // 

} 


// a message the active window changes. // 

) 


// -- Written by Paul R. Bonneau, 11/26/94. // 



/////////////////////////////////////////////////////// 

return msg.wParam; 


//include <windows.h> 

} 


//include <windowsx.h> 



//include "activtrk.h" 

LRESULT CALLBACK _export 

LwWndProcIHWND hwnd, UINT wm, WPARAM wParam, LPARAM IParam) 


char szClass[] = "ActiveWindowDisplay"; 

{ 

PAINTSTRUCT wps; 


void FormatlnfoWndCHWND hwnd, char *pszOut, 

char szBuf[512]; 


BOOL fNew); 

static HWND hwndNew; 
static HWND hwndOld; 


LRESULT CALLBACK export LwWndProcIHWND hwnd. 

RECT rect; 


UINT wm, WPARAM wParam, LPARAM IParam); 




switch (wm) 


//ifdef BORLANOC 

{ 


//pragma argsused 

default: 


//endi f 

break; 


int PASCAL WinMainCHINSTANCE hins, HINSTANCE hinsPrev, 



LPSTR lpsz, int wShow) 

case WM CREATE: 


{ 

if (! FRegisterWnd(hwnd) ) 


MSG msg; 

return -1; 


HWND hwnd; 

break: 


if (NULL == hinsPrev) 

case WM DESTROY: 


{ 

UnregisterWnd(hwnd); 


WNDCLASS wcs; 

PostQuitMessage(O); 

break; 


wcs.style = CS HREDRAW 1 CS VREDRAW; 



wcs.lpfnWndProc = LwWndProc; 

case wmActive: 


wcs.cbClsExtra = 0; 

hwndNew = (HWND)wParam; 


wcs.cbWndExtra = 0; 

hwndOld = (HWND)LOWORD(IParam); 


wcs.hlnstance = hins; 

InvalidateRectthwnd, NULL. TRUE); 


wcs.hlcon = LoadIcon((HINSTANCE)NULL, 

UpdateWindow(hwnd); 


IDI APPLICATION); 

return 0; 


wcs.hCursor = LoadCursort(HINSTANCE)NULL, 



IDC ARROW); 

case WM PAINT: 


wcs.hbrBackground = (HBRUSH )( COLOR_WINDOW + 1); 

BeginPaint(hwnd, &wps ) ; 


wcs.lpszMenuName = NULL; 

szBuf[0] = 0; 


wcs.lpszClassName = szClass; 

FormatlnfoWndthwndNew, szBuf, TRUE); 


if (! RegisterClass(&wcs )) 

FormatlnfoWndthwndOld, szBuf, FALSE); 


return FALSE; 

GetClientRectthwnd, Srect); 


} 

DrawTexttwps.hdc, szBuf, -1, &rect, 

DT LEFT | DT WORDBREAK I DT EXPANDTABS); 


msg.wParam = 0; 

EndPaintChwnd, &wps); 


if (NULL != (hwnd = CreateWindowExtWS EX TOPMOST, 

return 0; 


szClass, "Active Window", WS OVERLAPPEDWINDOW, 

} 


CW USEDEFAULT, CW USEDEFAULT, CW USEDEFAULT, 



CW USEDEFAULT. (HWND)NULL, (HMENU)NULL, hins, NULL))) 

{ 

ShowWindowthwnd, wShow); 

return DefWindowProcthwnd, wm, wParam, IParam); 

} 



while (GetMessage(&msg, (HWND)NULL, 0, 0)) 

void FormatlnfoWndtHWND hwnd, char *pszOut, BOOL fNew) 


{ 

/////////////////////////////////////////////////////// 
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valid registered window handle, the hook procedure sends 
the private message to the client's window, supplying the 
newly activated window handle via wParam, and the pre¬ 
vious active window via the low word of IParam. 

activtrk.h (Listing 2) contains prototypes for the two 
functions exported by the DLL, as well as a definition for 
the private message (I gave it the name wmActive). I de¬ 
cided it was okay to use a private message instead of a 
registered window message, because you will be compil¬ 
ing both client and DLL, and so can avoid message value 
collisions simply by changing the value for wmActive in ac¬ 
tivtrk.h. demoactv.c (Listing 3) demonstrates how to use 
the DLL. It displays the window handle and window title 


Listing 3 continued 


II -- Format window information into a text buffer. // 


// -- hwnd : Window to report on. // 
// -- pszOut : Output buffer. // 
// -- fNew : Input parameter, set for new // 
// active window msg, clear for // 
// previous. // 


/////////////////////////////////////////////////////// 

{ 

char szTitle[256]; 

char *pszType = fNew ? "New" : "\r\nPrevious"; 
char *pszTitle; 

if (IsWindow(hwnd)) 

{ 

GetWindowTextthwnd, szTitle, sizeof szTitle); 
pszTitle = szTitle; 

} 

else 

pszTitle = "Invalid"; 
wsprintfipszOut + 1strlen(pszOut), 

"Xs active window %x\r\n\tTitle: Xs", 
(LPSTR)pszType, (UINT)hwnd, (LPSTR)pszTitle); 

} 

/* End of File */ 


■ » • 

Listing 4 ToolHelp notification callback for task 

termination 


/////////////////////////////////////////////////////// 

// wait.c 

II 

// -- Routine waits for another task to terminate. 

1/ 

// -- Written by Paul R. Bonneau 11/25/94. 

II 

/////////////////////////////////////////////////////// 

#include <windows.h> 
include <windowsx.h> 

#include <toolhelp.h> 
tfinclude "wait.h" 


BOOL CALLBACK _export FNotifyProc(WORD nfy. DWORD lw); 

HTASK htskCaller, htskSpawned; 

UINT wmPrivate; 


BOOL CALLBACK export FWaitHins(HINSTANCE hins. 


BOOL 

*pfError) 

/////////////////////////////////////////////////////// 

// -- Wait for the given instance to terminate. 

// 

// -- Returns TRUE if the calling task should 

II 

// terminate. 

II 

// -- hins ; Instance of task to wait for. 

II 

// -- pfError : Set on return if an error occurred. 

II 

/////////////////////////////////////////////////////// 

{ 
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Listing 4 continued 


TASKENTRY tke; 

MSG msg; 

BOOL fResult = FALSE; 

BOOL fRegistered = FALSE; 

FARPROC lpfn = NULL; 

static BOOL fBusy; 

*pfError = TRUE; 

if (fBusy) 

goto LCleanup; // Already servicing a request. 
fBusy = TRUE; 

if (0 == (wmPrivate » 

RegisterWindowMessageCSpawnedTaskTerminated”))) 
goto LCleanup; 

// Get an instance thunk for notification proc. 
htskCaller = GetCurrentTaskO; 
tke.dwSize = sizeof tke; 

TaskFindHandle(&tke, htskCaller); 
if (NULL == (lpfn = MakeProcInstancet 
(FARPROC)FNotifyProc, tke.hlnst))) 
goto LCleanup; 

// Find task handle for the given instance. 
htskSpawned = NULL; 

TaskFirst(&tke); 
do 

if (tke.hlnst == hins) 

{ 

htskSpawned = tke.hTask; 
break; 

} 


BUG TRACKING 

TECHNICAL SUPPORT and more... 

^^^KTKSOFFRONT* 
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Listing 4 continued 


while (TaskNext(&tke)): 

// If we couldn't find the task, it has terminated 
// already. 

if (NULL == htskSpawned) 

{ 

‘pfError = FALSE; 
goto LCleanup; 

} 

// Install callback that looks for terminations, 
if (!NotifyRegister(htskCal1er, 

(LPFNNOTIFYCALLBACK)! pfn, NFJORMAL)) 
goto LCleanup; 
fRegistered = TRUE; 

// Now, just lounge around until we receive the private 
// message from the callback 
*pfError = FALSE; 
for (;;) 

{ 

if UGetMessageUmsg, NULL. 0, 0)) 

{ 

fResult = TRUE; 
goto LCleanup; 

} 

if (msg.message == wmPrivate) 
break; 

TranslateMessageL &msg): 

DispatchMessage(tasg); 

} 

LCleanup: 

if (fRegistered) 

NotifyllnRegi ster( htskCal 1 er); 
if (NULL != lpfn) 

FreeProcInstance(lpfn); 
fBusy = FALSE; 
return fResult; 

} 

#ifdef _BORLANDC_ 

ffpragma argsused 
#endif 

BOOL CALLBACK _export FNotifyProc(WORD nfy, DWORD lw) 
/////////////////////////////////////////////////////// 

// -- NotifyRegister() callback. // 

/////////////////////////////////////////////////////// 

{ 

if (NFY_EXITTA$K == nfy 
GetCurrentTaskO == htskSpawned) 
PostAppMessage(htskCaller, wmPrivate, 0, 0); 

return 0; 

) 

#ifdef _BORLANDC_ 

iipragma argsused 
#endif //_BORLANDC_ 

int CALLBACK LibMain(HINSTANCE hins, WORD ds, 

WORD cbHeap, LPSTR lsz) 

{ 

return 1; 

) 

// Symantec doesn’t supply a default WEP 

#1fdef BORLANDC 

#pragma argsused 
#endif 

int CALLBACK_export WEP(int wExit) 

{ 

return 1; 

) 


/* End of File */ 


text of the current active window, and the same informa¬ 
tion for the previous active window. The code disk (see 
the table of contents for availability) contains bldactiv.bat, 
a batch file that can compile and link the DLL and exam¬ 
ple program with Borland C++ v4.5. Visual C++ vl .5, Sy¬ 
mantec C++ v6.10, or Watcom C++ vl 0.0. 

Instead of using SendMessageO to inform the client appli¬ 
cation, 1 could have designed FRegisterMndO to accept a 
callback function. The problem with this approach is that, 
in general, Windows will call the DLL's CBT hook proce¬ 
dure from the context of some other task. If the DLL were 
to then call a callback function, it too would be running in 
the context of the other task, which can be a problem. For 
example, it would not be possible to perform I/O to any 
open file handles, since file handles are local to the cur¬ 
rent task. Suppose both the client and the other task had 
a file open for writing. It is entirely plausible that this han¬ 
dle could be the value 5 in both tasks (in fact, it's even 
likely, since file handles are locally obtained in increasing 
numerical order). So by writing to file handle 5, the client 
application would actually be scribbling over some other 
task's file. 

For the reason just stated, I chose to use SendMessageO 
to inform the client. SendMessageO actually performs a task 
switch before calling the target window procedure. Even 
though this approach is better than using a callback func¬ 
tion, it can still lead to problems. Some OLE2 interface 


Figure 1 A proposed algorithm for detecting task 
termination 


// Middle of program 

HINSTANCE ghlnstChild; 

MSG Msg; 

char ProgramModuleName[144], 1 pszFi 1 eName[144]; 

ghlnstChild = (HINSTANCE)WinExec( 

"C:\\WINDOWSWNOTEPAD.EXE CiWWINDOWSWREAOME", 
SW_SHOWNORMAL); 
if (ghlnstChild > 31) 

{ 

GetModuleFi1eName(ghInstChi 1 d, IpszFileName, 
144); 

lstrcpytProgramModuleName, IpszFileName); 

while (TRUE) 

{ 

GetModuleFileNametghlnstChi Id, 

IpszFileName, 144); 
if (0 1= 1strcmpi(ProgramModuleName, 
IpszFileName)) 
break; 

YieldO; 

} 

while (PeekMessage(&Msg, NULL, NULL, NULL, 
PM_REMOVE)) 

{ 

TranslateMessaget&Msg); 

DispatchMes$age(&Msg); 

} 

) 

// Remainder of program, 
return 0; 
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functions will fail when called from inside SendMessageO. If 
your application depends on OLE2, you may want to call 
PostHessageO instead of SendMessageO from the DLL's CBT 
hook procedure. The drawback is that notifications will be 
delivered asynchronously to your application, so it is con¬ 
ceivable that by the time your window procedure receives 
a wmActive message, some other window could have been 
made active, making the information provided with the 
message stale, in this case, you should call GetActiveUin- 
dou() in the code that handles the wmActive message. 


Visual C++ vl .5 
Borland C++ v4.5 
Symantec C++ v6.1 
Watcom C++ vl 0.0 


a shot in the dark (I had reached the end of my salary 
bracket on this one), I added the PeekMessageO routine. 
That seemed to help - most of the time. But not all of the 
time! And 'most of the time,' as you might well guess, is 
simply unsatisfactory. 

Any suggestions you may have would be duly appreci¬ 
ated. All of this is rather kludgy, I suspect, and that, of 
course, is precisely why I pen this missive for assistance. 

Lawrence P. Cohen 
United States District Court 
District of Massachusetts 
Boston, Massachusetts 02109 

(text continued on page 66) 


Q I read with interest your discus¬ 
sion (March 1994 Windows/DOS 
Developer's Journal, "Windows Ques¬ 
tions & Answers,' pp. 63-66) concern¬ 
ing the use/misuse of PeekMessageO. 

My question is along the same 
line, perhaps more basic. I simply 
want to execute a linear Windows 
program (no menus, no intended 
message loops), then, from within 
that program but before the termina¬ 
tion of that program, launch another 
program by calling UinExecO, have 
the original program wait pending 
the closing of the launched program, 
and have it restart upon the closing 
of that launched program. As I un¬ 
derstand it, UinExecO returns immedi¬ 
ately after the program is launched, 
returning a value of 32 or greater if 
successful. That, of course, would be 
enough if the launched program sim¬ 
ply did its doings in the background. 
But where the launched program is 
intended to do its doings in the fore¬ 
ground (for example, running 
notepad.exe to read a 'readme' file to 
acquaint the user with that which is 
to follow), my problems begin to 
multiply. 

The various publications explain¬ 
ing UinExecO are not very helpful on 
this score. Perhaps there is a simple 
solution. I have tried the routine in 
Figure 1, and it works - sometimes. 
Rather kludgy, I might add. Initially, I 
thought I had found success (in the 
debugging mode) with the first por¬ 
tion of the code - without the Peek¬ 
MessageO routine. But then, outside 
the debugging mode, the program 
simply froze, not recognizing mouse 
messages or the like. Then, simply as 
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while (IsInstance(hinsSpawned)) 


Listing 5 Header file for wait.c 


/////////////////////////////////////////////////////// 


// wait.h // 
// -- Interface to routine that waits for another // 
// task to terminate. // 
// -- Written by Paul R. Bonneau 11/25/94. // 


/////////////////////////////////////////////////////// 

BOOL CALLBACK _export FWaitHins(HINSTANCE hins. BOOL *pfError); 
/* End of File */ 


(continued from page 63) 

A Your biggest problem is that you 
are dealing with the 16-bit Win¬ 
dows API! This is one area of Win¬ 
dows that has real shortcomings. Un¬ 
like the Win32 API, which provides a 
rich set of process and blocking rou¬ 
tines, the 16-bit Windows API is very 
limited in the functionality it provides 
for process control. Fortunately, the 
ToolHelp API, which is really de¬ 
signed for debugger writers, can help 
fill the gap in 16-bit Windows. Tool- 
Help is a DLL ( toolhelp.dll ) that ships 
with Windows; you access it by in¬ 
cluding toolhelp.h and linking with 
toolhelp.lib (except with Borland 


C++, which incorporates toolhelp.lib 
in its default Windows import library). 

Let me first address some of the 
problems of coding a synchronous 
version of UinExecO in 16-bit Win¬ 
dows. UinExecO is an asynchronous 
routine; it will return at some arbi¬ 
trary time after the spawned task has 
been created. The big problem is 
how to create a robust function that 
waits for a task, identified only by its 
instance handle, to terminate. 

The usual attempt when coding 
such a wait function is to write a wait 
loop and poll for the existence of the 
spawned task - something like: 


The first problem is that there is no 
Windows API function that returns 
whether or not a given instance han¬ 
dle is valid or not. As you point out, 
the function GetModuleFileNameO ac¬ 
cepts a module handle and returns 
the path of that module. So perhaps 
converting an instance handle to a 
module handle and testing the result 
of GetModuleFileNameO could work. 
GetlnstanceModuleO, a macro defined 
in windowsx.h, does convert an in¬ 
stance handle to a module handle, 
so things are looking up. In fact, one 
can pass either an instance handle or 
a module handle to GetModuleFile¬ 
NameO, so the call to Getln¬ 
stanceModuleO is not really needed. 

But it turns out there are a few se¬ 
rious drawbacks. First, even though 
GetModuleFileNameO will return 0 if 
you pass an invalid module or in¬ 
stance handle, if you are running the 
debug version of Windows this 
API function will RIP (produce an 
"abort, break, ignore' message on 



LI DEVELOPER'S JOURNAL 

Windows/DOS Developer’s Journal buys dozens of articles each 
year from readers like you. You don't have to be a writer, but you 
do have to have a concrete topic of interest to other Windows 
programmers. Most of the articles we use are built around short 
(100-300 lines), reusable code that solves specific problems of 
interest to Windows programmers. The easiest way to propose an 
article topic is to send email about your idea to the editor, Ron 
Burk, via CompuServe at 70302,2566 or Internet at 
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70302.2566@compuserve.com. Make sure you include an esti¬ 
mate of the number of lines of code involved. 
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■ Proposals due 3 Apr 1995 
manuscripts due 15 May 1995 
Suggested topics: A “spy” printer 
driver that points out inefficiencies in 
your app’s printing algorithms. A 
“Code Fragment Repository” utility that 
lets you create and add to a database 
of code fragments you commonly in¬ 
sert in your editor (e.g., WinMain() 
shell). A DLL dependency checker 
that verifies that all the DLLs an .exe 
needs are present. 


User Interface 
Programming 

■ Proposals due 3 May 1995 
manuscripts due 14 June 1995 
Suggested topics: User-modifiable 
toolbar hints. A C++ class for undo¬ 
ing/redoing commands. A “smart” 
icon format that adapts to the cur¬ 
rent color depth. A function to auto¬ 
matically, intelligently handle dialog 
resizing. 


Graphics 

■ Proposals due 2 June 1995 
manuscripts due 14 July 1995 

Suggested topics: Adding “water¬ 
marks” to WinHelp topics. A C++ 
class for rendering and caching 
metafiles as bitmaps. Tips for han¬ 
dling huge bitmaps efficiently. 
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the debugging terminal). You might 
think, 'big deal, lots of commercial 
programs produce RIPs' (in fact, it is 
rare to find one that does not!), but 
the Microsoft developers put those 
RIPs in for a purpose, to warn you 
that you have a bug in your code. To 
rely on the continued behavior (in fu¬ 
ture retail versions of Windows) of a 
function that RIPs in the debug ver¬ 
sion is just asking for trouble. 

The second problem is that if an¬ 
other instance of Notepad is running, 
then GetModuleFileNameO will continue 
to return a valid path, even if the first 
instance, the one you spawned, has 
terminated. This is because all in¬ 
stances of the same program share a 
common module. Another problem is 
that it is conceivable that during the 
time between calls to GetModuleFile¬ 
NameO in your polling loop, the 
spawned instance of the task will 
have terminated, and the user will 
have created another instance of the 
same task. In this case you will be 
mistakenly waiting for the wrong in¬ 
stance to terminate. 

I have saved the worst problem 
for last. Since 16-bit Windows is a 
non-preemptive multitasking environ¬ 
ment, you can't simply sit in a tight 
loop waiting for the spawned in¬ 
stance to die. This will lock up all of 
Windows; no other task will have a 
chance to run, since your loop is not 
yielding control. The API function 
YieldO looks tempting as a way to 
solve this problem, but it really is not. 
I wish Microsoft had never docu¬ 
mented this particular function (and I 
would hazard they feel the same 
way). 

It is your call to YieldO that is the 
source of your lockup. When you 
yield in a tight loop, your application 
is not receiving messages; control is 
being passed to any other task with 
at least one message in its queue. If 
no such tasks exist, then the call is 
effectively a no-op. Now hardware in¬ 
put (e.g., mouse and keyboard) for all 
tasks in 16-bit Windows comes from 
a central system message queue, and 
messages can be removed from this 
queue only from the head. If a mes¬ 
sage for your application is at the 
head, with a message for some other 
application behind it in the queue. 


and your application is not extracting 
messages, then the system is locked. 

Replacing the call to YieldO with 
a call to PeekMessageO inside the poll¬ 
ing loop will prevent the deadlock - 
so long as you actually remove any 
messages that PeekMessageO finds. 
You will probably just want to dis¬ 
card the messages, unless your appli¬ 
cation has a window present while 
waiting for the spawned task to ter¬ 
minate. Even though this prevents 
deadlock, it is not an ideal solution. 
A PeekMessageO loop prevents the 
power manager on laptops from 
switching into power conservation 
mode, since the power manager 
must assume that your application is 
still doing useful processing. 

A better solution would be to 
somehow use a standard GetMes- 
sageO call inside the loop, since this 
will block your application unless 
there is a message pending for it. 
This would be in conjunction with 
some kind of notification that the 
task you have been waiting on has 
indeed terminated. Well, as I hinted 
at the start, the ToolHelp API allows 
you to implement exactly that. 

The key is TooIHelp's NotifyRegis- 
terO routine It lets you specify a 
callback function that ToolHelp in¬ 
vokes when certain system-level 
events occur. One such event occurs 
whenever a task terminates. The idea 
is that the callback function can listen 
for task termination events, and if 
the task being terminated is the 
same as the one being waited for, it 
can post a message which GetMes- 
sageO will retrieve to exit the wait 
loop. 

wait.c (Listing 4) contains the code 
for a function that uses the Noti¬ 
fy Register0 technique to implement 
the function FUaitHinsO. The proto¬ 
type for this function is contained in 
wait.h (Listing 5). The function ac¬ 
cepts the instance handle of the task 
to wait for, along with a pointer to a 
Boolean that the function sets if an 
error occurs. You can use FUaitHinsO 
from a normal windowed application, 
or one that does not possess win¬ 
dows. In the case of a windowed ap¬ 
plication, the UM_QUIT message 
could be received by the call to 
GetMessageO inside FUaitHinsO. If this 
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happens, the function returns TRUE, indicating that the ap¬ 
plication should exit. In all other cases, the return value is 
FALSE. 

The first thing FUaitHinsO does is to protect itself from 
re-entrancy. You could redesign FUaitHinsO to wait on 
more than one spawned task, but to keep the code here 
simple I've left that as an exercise for readers. The routine 
then registers a private window message. This message 
will be posted by the NotifyRegisterO callback function 
when the specified task terminates. Using a private, regis¬ 
tered message enhances portability, since the developer 
using the routine does not have to worry about potential 
message conflicts with any of the messages in the con¬ 
stant range (those //define' d in the range UM_USER through 
0x7FFF). 

Next, FUaitHinsO obtains an instance thunk for the No¬ 
tifyRegisterO callback, FNotifyProcO. Smart callbacks will 
not work in this case, since FNotifyProcO is essentially an 
interrupt routine, and can be called in the context of any 
application. Loading your DS from another application's SS 
is not a good method for accessing global variables (at 
least not yours)! MakeProcInstanceO requires the instance 
handle of the running task, but you will notice that I have 
not declared the instance handle of the current task as a 
parameter to FUaitHinsO. Since I have to use the ToolHelp 
TaskXXXO functions anyway (a little later on), I just used 
the TaskFindHandleO routine to fill in a TASKENTRY structure 
and thereby obtain the instance handle for the current 
task. 

Then, as promised, I use the TaskFirstO and TaskNextO 
ToolHelp API functions to convert the spawned task's in¬ 


stance handle into a task handle. FUaitHinsO then installs 
FNotifyProcO (via its instance thunk) and the routine is fi¬ 
nally ready to enter its polling loop. The loop is pretty 
straightforward. If GetMessageO returns false, it is because it 
has received the UM_QUIT message. In this case FUaitHinsO 
returns early; there is no point in waiting around, since 
the application calling it is terminating. Otherwise, if the 
private message is received, the spawned application has 
terminated, so control can be returned to the caller. 

The dregs of the code in FUaitHinsO perform cleanup 
duty by unregistering the NotifyRegisterO callback func¬ 
tion, freeing FNotifyProcO' s instance handle, and resetting 
the flag used to prevent re-entrancy. 

FNotifyProcO, is the next (and last) routine in the file 
and is pretty simple. If the current notification is for a task 
termination, and the terminating task is the same as the 
one the code is waiting for, it calls PostAppMessageO to de¬ 
liver the private message to the polling loop. I use 
PostAppMessageO instead of PostMessageO because 
PostAppMessageO works with both windowed and window¬ 
less applications. FNotifyProcO obtains the current task 
handle by calling GetCurrentTaskO. Even though the cur¬ 
rent task may be exiting, GetCurrentTaskO will return its 
handle. 

demouait.c (Listing 6) presents a tiny program that 
shows how a windowless application uses the FUaitHinsO 
routine. The code disk (see table of contents for availabil¬ 
ity) contains bldwait.bat, a batch file that can compile and 
link the DLL and example program with Borland C++ 
v4.5, Visual C++ vl.5, Symantec C++ V6.10, or Watcom 
C++ vlO.O. □ 


Listing 6 Demonstration of using ToolHelp for task terminate notification 


/////////////////////////////////////////////////////// 


// demowait.c // 
// -- Program demonstrates waiting for another to // 
// terminate using the FUaitHinsO routine. // 
// -- Written by Paul R. Bonneau 11/25/94. // 


/////////////////////////////////////////////////////// 
//include <windows.h> 

//include "wait.h” 

tfifdef _WATCOMC_ 

//pragma off (unreferenced); 

/fendif 

char szThisApp[] = "Spawn & Wait"; 
char szSpawnApp[] = "notepad.exe"; 
char szArgs[] = "wait.c"; 

void Report(char *pszFormat. BOOL fError) 

{ 

char szBuf[256]; 

wsprintf(szBuf, pszFormat, (LPSTR)szSpawnApp); 
MessageBox((HWND)NULL, szBuf, szThisApp, 
fError ? (MBJCONHAND I MB_0K) : MB_0K); 

} 


#ifdef_BORLANDC_ 

//pragma argsused 
//endi f 

int PASCAL WinMain(HINSTANCE hins, HINSTANCE hinsPrev, 
LPSTR Ipsz, int wShow) 

{ 

char szBuf[256]; 

BOOL fError; 

wsprintf(szBuf, "Its its", 

(LPSTRJszSpawnApp, (LPSTRJszArgs); 
if (HIN$TANCE_ERROR > 

(hins = (HINSTANCE)WinExectszBuf, wShow))) 

{ 

Reporters failed to spawn", TRUE); 
return 0; 

} 

// A windowed application should check this return 
// value. 

FWaitHinsthins, &fError); 

ReporttfError ? 

"Error encountered" ; "%s terminated", fError); 
return 0; 

} 

/* End of File */ 
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Books in Brief 

First Impressions of Recent Titles 


Modifying Windows 

A Compilation of the Best and Most 
Useful Windows Programming Topics 

Asael Dror 

ISBN 0-07-881993-8 

281 pages 



This book is based on articles which appeared in Win¬ 
dows Developer Letter, a technical newsletter which the 
author created. The book contains an ad for the newslet¬ 
ter ($250 for 12 issues, normally $300) and an ad for ob¬ 
taining a code disk for the book ($25). The code is Mi¬ 
crosoft-specific, but the author says porting the code to a 
different compiler is 'easy." Such statements always make 
me think: "If it's so easy, why didn't he just go ahead and 
do it?" Since I spend more time than most making code 
work with multiple compilers, I can tell you that some¬ 
times it is easy and sometimes it is a hassle. In this case, 
one clear trouble spot for non-Microsoft programmers will 
be command-line options; the code calls for more than 
one style of exported function prologue/epilogue code, 
and compiler documentation is notoriously poor at ex¬ 
plaining which compiler options generate which prologue. 
On the plus side, the author compiled with the STRICT op¬ 
tion (all book authors should do this), making it much 
more likely that the bulk of the code will move easily to 
other compilers. The introduction fails to note the need 
for an assembler, but a minority of the example source 
files are in assembly language. 


Ron Burk 

The first chapter is devoted to extending and customiz¬ 
ing the common dialogs that come with Windows 3.1. It 
includes code examples for providing a common dialog 
hook procedure and for modifying an existing common 
dialog template. The second chapter is devoted to describ¬ 
ing DLLs - how they work, how to import and export 
functions, and so on. Much of this chapter (compiler op¬ 
tions, runtime library names, etc.) is entirely specific to Mi¬ 
crosoft's compiler. Chapter 3 is titled 'Advanced Windows 
Debugging,' and it discusses the debugging kernel, DBWIN 
(a Microsoft-specific debugging output viewer), and the 
functions you can call for debugging output. Chapter 4 is 
devoted to superclassing and subclassing windows; the 
main example is a DLL that modifies the behavior of the 
Windows Solitaire game. Chapter 5 is about SetUindow- 
sHookExO, the Windows function for intercepting various 
kinds of messages. Chapter 6 covers the installable device 
driver interface. Chapter 7 discusses the ToolHelp API, and 
includes the oft-repeated example of using ToolHelp notifi¬ 
cations to determine when a spawned application termi¬ 
nates. Chapter 8 is titled 'Dynamic Link Interceptors"; its 
crux is showing how to intercept all calls to a DLL by re¬ 
naming it and inserting your own replacement DLL, which 
forwards calls (after spying on them) to the original DLL. 

The book covers a variety of topics; for most of the 
topics, it is not the most comprehensive source. If you 
own Undocumented Windows, you already have a more 
complete introduction to the ToolHelp DLL. If you own 
Richter's Windows 3.7: A Developer's Guide, you already 
have a more complete introduction to SetMIndowsHookExO. 
On the other hand, this book is not padded with code and 
fluff, as many Windows programming books are - what 
there is is all meat. The chapter on installable device driv¬ 
ers, while not by any means a complete guide to creating 
device drivers, is the most complete description of the 
crudely documented installable device driver interface I've 
seen. If this book had come out three years earlier, it 
would have been great. As it is, much of its territory has 
been covered by books and magazines. Nevertheless, it is 


You can order any of the books that appear in Books in Brief from R8D Publications by calling (913) 841-1631, faxing 
(913) 841-2624, or sending email to rdorders@rdpub.com. if using fax or email, send the book title, author, and publisher 
along with your MasterCard or Visa number, expiration date, and phone number. 
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stiil far above the dismal average quality of Windows pro¬ 
gramming books. 
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167 pages 
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SOLUTIONS 
FOR C/C++ 
PROGRAMMERS 


If you program in C/C++ you need the 
solution-oriented information found only 
in C/C++ Users Journal. We devote 12 
issues every year to the language of 
choice, C/C++. Each issue is crammed 
with information on ANSI C, C++, de¬ 
bugging, tutorials, code and more. 

A FREE issue of C/C++ Users Journal 

is yours — call now and ask for a trial 
subscription. If you like the code-inten¬ 
sive C/C++ programming solutions you 
find in your FREE issue, pay only $34.95 
for a full year’s subscription. If not, write 
‘cancel’ on the accompanied invoice 
and owe nothing. There’s NO RISK and 
NO OBLIGATION. 
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A dvanced Solutions for C/C++ Programmers 


Software Tools 

• Analyzing Inputs 
of Unknown Syntax 

• Standardizing ' 

Standard C 



The subtitle of this book is 'A Digital Tour of the Best 
Animated Movies for Your Multimedia PC." The CD con¬ 
tains Video for Windows and a program that helps you 
select which of the many computer-generated videos on 
the CD you want to play back. The book itself starts with 
an introduction to computer animation, providing a very 
brief, high-level overview of how one would create a com¬ 
puter animation with Autodesk's 3D Studio. The bulk of 
the book is a set of capsule summaries of the animations 
on the CD. Each summary lists the title, author, company, 
software used, and computer platform, and has a snap¬ 
shot of the animation along with a brief description of 
why it was made and any interesting facts about how it 
was made. 

_ The animations on the CD vary in 

length from only a few seconds to 
over a minute in some cases. There 
are animations made for commer¬ 
cials, animations made to illustrate 
car accidents for legal cases, anima¬ 
tions made by students for classes, 
even animations to illustrate scientific 
principles. One of the more interest¬ 
ing animations was "Relativistic City," 
which shows that flying by a city at 
near the speed of light would look 
far different than my passing under¬ 
standing of relativity would predict. 

I'm not quite sure who this book 
is good for, since it does not have 
much in the way of detailed technical 
information. Artists might find some 
useful (but brief and high-level) de¬ 
scriptions of how to achieve particu¬ 
lar effects with specific animation 
packages. While I would not have 
paid $32.95 for the book myself, it 
certainly did produce some of the 
most visually interesting images my 
computer screen has ever seen. 
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Addison-Wesley, 1994 
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This book actually appeared with 
an 'Advanced Computing' label in 
my local Software Etc. store. Given 
how difficult it can be to send email 
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sometimes, that may not be as odd as it sounds. The back 
of the book says it is the "first book that lets you get 
directly in touch with people who make a difference." It 
says, "Have a serious conversation with Bill Gates (or Tom 
Clancy or Ed Asner or Vinton Cerf...).' Wow! I had not con¬ 
sidered that rich and famous people might be out there 
on the net every day, just waiting for the chance to chat 
with me. Once I thought about it, though, it seemed plau¬ 
sible - what else do these folks have to do all day? I'm 
one of the rich and famous people whose email address is 
listed in the book, so I figured I would break the ice by 
sending some of my famous colleagues a short note to 
see what they thought of the book. I sent the following 
email message: 

To: «email address» 

Dear «rich and famous person», 

I am doing a book review of 'E-mail Addresses of the 
Rich & Famous", by Seth Godin which claims to be 'the first 
book that lets you get directly in touch with people who 
make a difference." To see if these addresses are real and 
useful, I have selected yours completely at random and 
would greatly appreciate it if you could answer the follow¬ 
ing short questionnaire: 

a) Are you rich? 

b) Are you famous? 

c) How do you 'make a difference"? 

Thanks for any comments you can send me. 

Ron Burk, Editor 
Windows/DOS Developer's Journal 

I inserted the names and addresses of several famous 
people from the book and sent it out, checking my mail 
every few hours for a response. 

Because he was listed with a CompuServe address, I first 
sent my note via CompuServe to Pulitzer Prize-winning 
author Dave Barry. Unbelievably, an answer came winging 
back within minutes! Unfortunately, the answer was: 

? EMDRNF Receiver not found. [73314,722] 

Maybe he was just playing a little joke on me. I next sent 
mail to Butthead, noted MTV child actor. His response was 
also quick, but much more verbose, and here is an ex¬ 
cerpt: 

#: 4433 S0/CompuServe Mail [MAIL] 

02-Feb-95 17:40 PST 
Sb: Returned mail: User unknown 

. The following addresses had 

delivery problems - 

butthead@mtv.com (unrecoverable error) 

. Transcript of session follows . 

... while talking to mtv.com.: 

»> RCPT To:<butthead@mtv.com> 

«< 550 <butthead@mtv.corn?... User unknown 
550 butthead@mtv.com... User unknown 

Predictably, co-star Beavis sent an entirely similar re¬ 
sponse. 


I was getting a little discouraged. What are the odds 
that I can "have a serious conversation with Bill Gates" if 
neither Butthead nor Beavis is willing to talk to me? I 
pressed on, though. Mail to Matt Groening, creator of sat¬ 
ire, elicited reams of email error headers. As did a mes¬ 
sage to Garrison Keillor, famous radio show host. In fact, 
the most encouraging response I got from all the email I 
sent came from Paula Poundstone (famous comedian), 
who sent no reply at all. Perhaps she is out of town on 
tour and will reply later. 

Despite multiple attempts, I never did get to communi¬ 
cate with anyone rich or famous listed in this book. It did 
occur to me that email is not always the great leveler it is 
touted to be. It could be that rich and famous people just 
want to use email and online services for their own pur¬ 
poses, rather than have such services be used as a con¬ 
duit for the rest of us to contact them. Maybe they would 
have requested "unlisted" email addresses with big elec¬ 
tronic fences and computerized barking dogs, if such 
things existed. I'm probably just being cynical though - 
let's all drop a note to bi 11 g@microsoft. com today! 


gj TWAIN support for your application WETE? 


0 Do you want to support scanners with your 
Windows application? 


0 Do you think it makes sense to support 
TWAIN, the industry standard? 


0 Do you want to save your resources? 
Do you want to save money and time? 


The TWAIN Integration Kit™ is the best choice to implement 
TWAIN in MS-Windows applications. Forget about the estimated 
20 'man days' for the development of a TWAIN implementation. 
With the TIK you can have TWAIN in your application within a 
day or less. For the value of only a few 'man days', you will get 
the powerful and easy to use TIK DLL. The price is only $1995 
and there are and no runtime licenses. Order now or test the trial 
version first with a subset of commands for only $250. We are 
looking forward to your order or inquiry for further details on the 
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Giga Bites: The Hacker Cookbook 
Jenz Johnson 

96 pages of gastro-intestinal strife 
$9.95 

Ten Speed Press 
ISBN 0-8981 5-644-0 



About a decade ago, before the term gained more 
negative connotations, I was a 'hacker' at Kansas Univer¬ 
sity. I would get up at about 9pm, get dressed, and scurry 
out for a breakfast of tacos or hamburgers before the fast 
food joints closed. After eating and studying the previous 
night's listings (on big, green-bar paper), I would head for 
the computer center, confident that most of the amateurs 
had gone home and I would soon have a multi-million- 
doilar mainframe all to myself. Around 3am, it was time 
for a light lunch, usually a Coke and a Snickers bar, some¬ 
times two. Finally, when the earlier risers began logging 
on and slowing down the old B compiler, I would print 
fresh listings and head for home, perhaps grabbing a 


quick supper of drive-through freeze-dried-but-microwaved 
hash-browns-in-a-box. 

I mention all this because I thought I ate some pretty 
terrible stuff in my time, and was probably the target audi¬ 
ence for this book of hacker recipes. I was mistaken. Even 
though it is meant to be somewhat humorous, after read¬ 
ing a few recipes here my appetite was completely gone. 
If I ever ate stuff this bad, my brain has mercifully erased 
the memory. Buy this book at your own risk - these are 
some disgusting recipes. Here's a sample: 

Leftover Macaroni and Ice Cream Pie 

This bulkier dessert combines the practicality of getting rid of old 
food with the coolness of ice cream. Your guests will love it, but 
make sure that you serve enough wine during dinner. 

2 cups leftover macaroni 
1 gallon ice cream 

1 cup chocolate syrup 

1 cup chopped nuts 

1 baked pie shell 

10 seconds whipped cream (canned) 

• Mix the macaroni and ice cream until smooth. Add the syrup 
and nuts and quickly toss. 

• Ladle mixture into the pie shell and put back into freezer. Prior 
to serving, add the whipped cream. 

SERVES: 2 or 3 
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time and on budget. 
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OLE 2.0 and DDE Distilled 

A Programmer's Crash Course 
Al Williams 

$36.95, includes 3.5" diskette 
318 pages 

Addison-Wesley, 1994 
ISBN 0-201 -40639-X 



The hardest part about using Microsoft's APIs is that 
Microsoft rarely does a competent job of documenting or 
explaining them. In particular, I have seen Microsoft lectur¬ 
ers set whole rooms of programmers to scratching their 
heads on the subject of OLE more times than I care to 
remember. Part of the problem is that these folks insist on 
inventing new jargon and high falutin' phrases to go with 
each new API, as though they had invented a new branch 
of physics rather than a minor variation on existing soft¬ 
ware. The good parts of this book are the parts that pro¬ 
vide plain English translations of traditional Microsoft ob¬ 
fuscation. For example, on the subject of OLE interfaces, 
the author says they are "simply a table of function point¬ 
ers that perform operations on an object" and "providing 
an interface is just a fancy way of saying your program 
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must supply certain routines and keep an array of func¬ 
tion pointers to pass to certain OLE API calls.' I would 
have learned a lot more about OLE a lot sooner if some¬ 
one had talked or written like that. Another positive as¬ 
pect of this book is that its examples do not require Mi¬ 
crosoft's application framework (MFC) - the code is mostly 
bare C. Some authors who claim to teach OLE are in fact 
just teaching how to push buttons in the Visual C++ IDE. 

The cover of the book says that the "disk includes reus¬ 
able functions and programming tools' but does not say 
that the disk is copyrighted and you do not have permis¬ 
sion to use the code it contains. The code disk was also a 
pain to use. The install program had a pretty, bitmapped 
greeting screen, but could not create a target directory for 
me, and then did not inform me (until the deeds were 
done) it was going to clutter up my registry and add a 
program group; it also apparently failed to copy over 
some files (including a makefile) - just using a .zip file 
and a readme, txt would have been friendlier. I tried to run 
one of the executables, but it required a Borland DLL I did 
not have. I tried to build one of the examples, but some 
source files were not in the right directories, and I never 
did find some bitmaps that the code wanted. The book 
made an effort to be compatible with both Borland and 
Microsoft, but it is not a trivial task to try to ship signifi¬ 
cant OLE code that works out of the box with both com¬ 
pilers. Still, it's hard to believe anyone ever actually tested 
this code disk before it was published. Perhaps it's just 
that I expect to do a reasonable amount of futzing when 
I'm handed source code in the form of a simple .zip file, 
but have a higher set of expectations when the code is 
installed by a GUI program that drops various pieces all 
over my hard disk. 

The OLE portion of the book is around 170 pages. 
Within about ten pages, you have a small program, writ¬ 
ten in straight C, that uses OLE structured storage to store 
multiple .c files in a single DOS file. That quick move to 
an actual, working OLE program was quite appealing to 
me. Of course, one can only simplify so much, and consid¬ 
erably more space in the book is devoted to showing you 
how to implement an OLE container and an OLE server. 
This small a book cannot demystify the entire ocean of 
OLE interfaces, but it takes a pretty good shot at turning 
OLE-ignorant programmers into at least OLE novices. 

I did not spend any time looking at the portion of the 
book devoted to DDE, mainly because that subject has 
been covered by other books and I suspect most readers, 
like me, would buy this book for the OLE content, not the 
DDE content. Of course, DDE and OLE 2 are related con¬ 
ceptually, but my cynical nature led me to suspect that the 
motive for combining them here was based more on what 
material the author had on hand than on what would be 
the best value or most cohesive read for the reader. Even 
just a light crash course on OLE 2 could easily fill a book 
by itself. If this book cost $9.95 and were devoted solely 
to OLE 2, I would recommend it to everyone as a quick 
way to get your feet wet in OLE 2. At $36.95, though, if 
your budget is limited you will almost certainly want to 
forgo this book in favor of Brockschmidt's Inside OLE 2, 


since it is currently the best all-around book on the subject 
(though I live in hope that better ones are coming). If your 
problem is not coming up with $37, but getting some in¬ 
itial grasp of what the heck OLE is about and how you 
actually would write code to use it, give this book a try. 

A book that gives a quick but concrete, plain-Engiish, 
hands-on introduction to one of the many occult Microsoft 
APIs is a great idea. This book did not pull it off as well as 
it could have, but I think the author had the right concept. 

Let's Talk Books 

Sb: Mistitled book competition 
Ron Burk, 

I read your December review of the BYTE books in 
Windows/DOS Developer's Journal with some mirth. I would 
like to tell you about my anger after shelling out a small 
fortune for a certain Heavy Metal OLE 2.0 Programming by 
Steven Holzner, published by IDG Books. Here in Australia 
we pay exorbitant prices for books (and music CDs) as a 
result of the collusive pricing policies of the country's main 
distributors. I paid AUS$80.00 for Heavy Metal OLE. In retro¬ 
spect, I should have bought $80 worth of McDonald's 
hamburgers, as it would have been better value. 

I don't know whom Mr. Holzner is trying to kid, but he 
fooled me and I am a professional software engineer. 
When I saw this title in the book shop I thought "Great - 
a book to augment Bill's CD-ROM based documentation." I 
flicked through it and it looked okay so I forked out the 
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AMEX card. After taking it home and reading it over the 
Christmas vacations, a different realization emerged. 

This book is only worth the paper it is printed on. It is 
not really suitable for toilet paper because it is too thick. 
Better to stick with the CD-ROM based stuff - at least the 
technical information is there. I would estimate that this 
book is 60% listing and 15% dumps of useless App Stu¬ 
dio/Workbench screens, with a remaining 25% of very du¬ 
bious technical information. Most of the code is AppWiz- 
ard generated. 

I feel that the author probably does not have a good 
grasp of the topic at all. For example, there is no mention 
of the MM_ANIS0TR0PIC mapping mode that is needed by 
any decent OLE server in order to generate scalable 
metafiles. The examples appear to be watered-down ver¬ 
sions of the Microsoft MFC OLE2 examples. Better to stick 
with Bill's examples; at least his technical writers under¬ 
stand what they are writing about. 

I am sick of being exploited by cynical book publishers. 
IDG and Mr. Flolzner have certainly earned my disrespect. 
Long live decent publishers like Addison-Wesley, Prentice 
Hall, and O'Reilly. 

Yours sincerely, 

Chris Undery 

This sounds oddly similar to my opinion of Mr. Holzner's 
Heavy Metal Visual C++ Programming, as expressed in the 
January issue. Both OLE 2.x and Visual C++ are darned big top¬ 
ics and I guess it is not too surprising that if the same author 
emits books on both topics in a short time, the quality leaves 
something to be desired. 

I think that sometimes book publishers must sound very 
similar to software managers ("We must publish this book in 
four months - we have a narrow window of opportunity!"). 
Hopefully, this sort of quickly produced, shallow book wilt not 
discourage authors out there who are taking the necessary 
months (sometimes years) to write more in-depth books on 
these topics. While it is probably true that quality does not al¬ 
ways pay for itself, I think O'Reilly has shown that it is possible 
to use quality to make a profit in markets that were viewed by 
many as already well mined, -rib 

Sb: Good book: Inside VC++, Kruglinski 
Fm: Richard Muller [76450,3542] 

I've bought eight VC++ books, most of them recently, 
because I decided to get serious about MFC programming. 
I have some vague recollection, mistakenly I hope, that 
you recently unfavorably reviewed: 

Inside Visual C++, 2nd Edition, Version 1.5 
David J. Kruglinski 
Microsoft Press, 1994 

I find this book to be excellent! His program nuggets to 
demonstrate various techniques are succinct and 'publica¬ 


tion quality." All nuggets are written in a rigorously consis¬ 
tent fashion. And all are accompanied by text which ex¬ 
pands on the rationale for the approach chosen, some¬ 
times with a history of relevant Windows development is¬ 
sues, and sometimes with alternative approaches. 

A minor flaw is the occasional occurrence of inaccurate 
printing of the source code. This is offset by the fact that 
the accompanying code disk contains completely accurate 
code, including headers, resource scripts, and make files. 

Just to offer perspective to the reader of the foregoing 
evaluation, I wish to mention that as of this writing I'm 
only about one-third of the way through the book. Also, 
my background includes about 30 years as an applica¬ 
tions programmer in a wide variety of environments, in¬ 
cluding 10 years of C and C++ programming. Finally, keep 
up the good work on W/DDJ. 

Regards, 

Richard 

I felt the book failed in its overall mission. I just could not 
extract much conceptual understanding of the big picture, espe¬ 
cially on the subject of MFC, which I feel is the most important 
topic for a book about Visual C++. Also, I think it is a little crazy 
to try to cover huge topics like OLE in a chapter or two, al¬ 
though I appreciated the fact that Kruglinski was savvy enough 
to point out that understanding how to generate OLE applica¬ 
tions with Visual C++ is not the same as understanding OLE. 

One problem I have not yet conquered with these book re¬ 
views is summarizing the strengths and weaknesses of the 
books so that readers come away with more than just a 
thumbs-up or thumbs-down opinion. For example, there is a 
class of books I label as just plain bad because the authors did 
not do much work; either they padded the book furiously with 
screen shots and generated code, or they simply offer lightly re¬ 
hashed versions of existing documentation. Kruglinski's book is 
definitely not in that category, and it clearly represents a lot of 
work and contributes useful information. Thought it may have 
failed to impart a good conceptual understanding of Microsoft's 
application framework, it definitely communicated how to per¬ 
form a variety of specific tasks. I think the book failed at what it 
set out to accomplish, but so far I have not found a better Visual 
C++ book. 

In searching for good Visual C++ information, I overlooked 
a rather obvious source: the Microsoft manuals. Microsoft's de¬ 
veloper documentation has traditionally been fairly inadequate, 
so much so that I quit reading it for the most part. To my sur¬ 
prise, the Visual C++ 2.0 manual Programming with MFC and 
Win32 has better conceptual information for MFC than any of 
the Visual C++ books I have examined so far. 

Thanks for sending in your thoughts on your experience 
with this book. Feedback from programmers who actually 
plunked down their own money to buy the book tends to be at 
least as interesting and relevant as the average book review. □ 
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Bug++ of the Month 

Mark Nelson 


The C++ runtime library includes a set of functions and 
overloaded operators designed to replace the stdio func¬ 
tions found in the ANSI C library. These functions, referred 
to as iostreams, are collectively designed to plug some of 
the biggest safety leaks found under C. 

One of the things I like best about iostreams is that it 
fixes my worries about vsprintfO. It seems that I'm al¬ 
ways writing functions to collect error or logging informa¬ 
tion. I usually have a prototype that looks something like 
this: 

ErrorMessage( char *fmt, ... ); 

Inside the ErrorMessageO function, I use vsprintfO to for¬ 
mat the arguments into a string variable which can then 
be written to a log file, the screen, a serial port, or some 
other destination: 

vsprint( buf, args ); 


The problem with this system is that I have no idea in 
advance how much space my output string requires. Even 
at runtime, inside ErrorMessageO it is nearly impossible to 
calculate the size of the output. To do so, you would virtu¬ 
ally have to recreate the vsprintfO function yourself - an 
unsavory prospect indeed! 

With iostreams, I can use a strstream object and send it 
as much output as I want. The library code takes care of 
allocating space as it is needed and, even better, avoids 
those nasty type mismatches so common in the printfO 
family. My error code might end up looking like this: 

ostream s; 

s « "Error reading data. Code = ” 

« code 

« ", returned message = ” 

« mess 
« ends; 

log_data( s.strO ); 


Mark Nelson is a programmer for Creenleaf Software and a student at the University of Texas at Dallas. Mark is the author o/The 
Data Compression Book and Serial Communications: A C++ Developer's Guide, both from M9T Books. You can reach Mark 
on CompuServe at 73650,312. 
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A Borland iostream Bug 

If you believe the exhortations of the C++ gurus, the 
functions in stdio.h are for Neanderthals only. Any pro¬ 
grammer worth his or her salt should make the switch to 
iostreams, and make it now! 

In theory, this makes sense. The problem, however, is 
that the stdio library functions have been hammered on 
by millions of programmers for the past 20 years. The 
body of experience with iostreams is only a small fraction 
of that, which can mean only one thing: bugs. 

I've already covered some of Microsoft's iostream bugs 
in this column, so it is only fair that I turn a critical eye 
towards Borland. This month's bug was reported by Pierre 
Gatz, a user of Borland C++ 4.5. Pierre found that after 
using the tellgO function (the iostream equivalent of 
ftelK)), his input file pointer became scrambled. 

I wrote a very simple test program, shown in Listing 1. 
bug013.cpp reads in its own source file, and prints the out¬ 
put to cout. If all goes well, when you run bug013.cpp, you 
will see a listing of the source code. 

When you compile bug013.cpp with Borland C++ 4.5, 
though, the output isn't so pretty. The first few lines of 
output should look like this: 

// 

// This program demonstrates a bug in Borland’s C++ 4.5 
// run time library. The program simply sits in a loop 
// reading in lines from this source file and sending 
// them to stdout. It works properly until you put 
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Instead, on my computer, I see this: 

// 

demonstrates a bug in Borland's C+r 4.5 
rary. The program simply sits in a loop 
ines from this source file and sending 
It works properly until you put 

It seems that simply calling tellgO on an input file stream 
moves the input pointer to a slightly different position, 
rendering it useless. 

Don Bornblaser at Borland quickly acknowledged the 
bug, and promised a timely fix: 

We are aware of this bug and a fix is in the works, it will 
be delivered to customers via the update CD we are ship¬ 
ping in March. 

It's nice to know this problem will be fixed quickly. I only 
wish that I was able to have a little more faith in the 
iostreams implementations of both Microsoft and Borland. 
Until then, I think I'll stick with that old standby, stdio.h. 

Thanks (and a stylish W/DDJ t-shirt) go to Pierre Gatz. 
Please send your contributions to wdletter@rdpub.com. If we 
use your bug in a future column, you can join Pierre on 
the C++ Programmer's Best-Dressed List. □ 


Listing 1 bug013.cpp — Demonstrating the tellgQ 
bug in Borland’s C++ 4.5 runtime library 


// 

// This program demonstrates a bug in Borland's C++ 4.5 
// run time library. The program simply sits in a loop 
// reading in lines from this source file and sending 
// them to cout. It works properly until you put 
// the call to tellgO in the loop. For some reason, 

// tellgO changes the position of the input pointer, 

// resulting in mangled output. 

// 

// To see the bug. compile like this: 

// 

// bcc bug013.cpp 
// 

// To see it work properly: 

// 

// bcc -DNOJUG bug013.cpp 
// 

// Note that the bug shows up in both the 16 and 32 bit 
// versions of the iostreams library. 

// 

♦Include <fstream.h> 
include <stdio.h> 

int main!) 

{ 

ifstream input! ”bug013.cpp" ); 

while ( input ) { 
char 1ine[ 256 ]; 
input.getline! line. 256 ); 
cout « line « endl; 

#if !defined! NO_BUG ) 
input.tellgO: 

#endtf 

} 

return 1: 

5 

// End of File 
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What’s Wrong with This Code? 

Pete Davis 


A routine I wrote, called SaveProfileStringO, simply 
writes a string to win.ini by calling UriteProfileStringO. 
Clearly, if you write a string with UriteProfileStringO and 
then retrieve the same string with GetProfileStringO, the 
two strings should be identical, right? To test this obvious 
assumption, SaveProfileStringO carefully makes a copy of 
its input string, passes the copy to UriteProfileStringO, 
then calls GetProfileStringO and compares that with the 
original string. If the two strings are not equal, then 
SaveProfileStringO returns FALSE. The surprise is that there 
are a variety of conditions under which SavePro¬ 
fileStringO does return FALSE - that is, the string that 
comes back from win. ini is different than the string that 
was written. Why would this function return FALSE? 

^include <windows.h> 
include <string.h> 

BOOL SaveProfileStringO 
const char *pszSection, 
const char *pszSetting, 
int Length) 

{ 

char sz$etCopy[256], szTest[256]; 
memcpy(szSetCopy, pszSetting, Length); 
WriteProfileStringC'MyApp", pszSection, pszSetting); 
GetProfileStringC'MyApp", pszSection, szTest, 256); 
if (memcmp(szTest, szSetCopy, Length)) 
return FALSE; 
return TRUE; 

} 


Solution 

Strictly speaking, there's nothing wrong with this code, 
but I've come up with no less than four situations that 
cause this function to return FALSE First, if the input string 
contains leading spaces, they get written to the .ini file, 
but GetProfileStringO removes them. Second, if the input 
string contains trailing spaces, UriteProfileStringO re¬ 
moves them and they do not go into the .ini file. Third, 
UriteProfileStringO refuses to store certain characters in 
the .ini file - ASCII values 0 through 13, to be specific. 
Finally, .ini files are limited to 64Kb. If calling UritePro¬ 
fileStringO would require it to write beyond 64Kb, noth¬ 
ing happens. Reading back will either fail (if nothing was 
written) or return part of the string (if the string itself 
crossed that 64Kb boundary). 

The reason I made a copy of the input string first is 
that UriteProfileStringO has a nasty bug. Even though it 
declares its input string as a const parameter, UritePro¬ 
fileStringO actually removes trailing blanks by poking a 
NULL byte into the input string. If you have used compiler 
options to store string constants in code segments (to 
avoid using up precious DGROUP space), passing a string 
constant with trailing blanks to UriteProfileStringO can 
produce an instant GP fault! □ 


Pete Davis is an independent consultant. He is currently working on a book tentatively titled Undocumented Windows File For¬ 
mats, to be published by R8D Publications, Inc. The book should be available in 1995. Pete can be reached on CompuServe at 
71644,3570. 
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New Products 

Industry-Related News & Announcements 


Import/Export Application Gets VBXAPI 

The OpenExchange VBX/Developer's Kit is a tool for 
developers who want to add data import and export fa¬ 
cilities to their Windows applications. OpenExchange 
PRO is the application that provides the actual import/ex¬ 
port processing, while an included VBX gives your appli¬ 
cation a convenient API for accessing OpenExchange 
PRO via the normal VBX properties, events, and meth¬ 
ods. The toolkit supports formats including MS-Access, 
Foxpro, Btrieve, Paradox, dBase, ASCII, Excel, and Lotus. 
The user sees a drag-and-drop interface for mapping in¬ 
coming fields to the host database. A built-in data diction¬ 


Inmark Ships zApp X/Motif Suite 

zApp is a multi-platform, C++ GUI development pack¬ 
age, now available for X/Motif. The zApp Developer's 
Suite for X/Motif includes the zApp Application Frame¬ 
work, the zApp Interface Pack, and the zApp Factory. The 
application framework is a set of C++ classes that imple¬ 
ment common GUI functionality in a platform-inde¬ 
pendent manner. The interface pack is a set of custom 
controls and high-level visual objects for building applica¬ 
tions. The zApp Factory is an interactive designer, code 


PRONEXUS Ships Multi-Line FAX VBX 

VBFax is a Visual Basic custom control (VBX) that 
helps developers create fax applications using Visual Ba¬ 
sic. It can be used standalone or as a part of VBVoice, a 
voice integration toolkit for Visual Basic. The VBX lets 
you create and view fax documents, send faxes during a 
voice call, queue faxes for later transmission, receive 
faxes during a voice call, and receive faxes off-line. 

VBFax can control up to 10 fax modems, and supports In¬ 
tel SatisFAXtion and Gammalink fax cards. VBFax accepts 


ary lets the developer or system administrator define 
what host database files are available for import/export 
and the data validation rules that apply to each. The 
product supports record locking and indexes. 

The OpenExchange VBX/Developer's Kit costs $495 
for a 10-user runtime license, or an additional $295 for a 
royalty-free license. For more information, contact 
Innovative Solutions & Technologies, 904 Jefferson Ave., 
Joplin, MO 64801, (417)781 -3282; fax (417)781 -3299; 
74722.3231 @compuserve.com. 


generator, and design testing facility for building user in¬ 
terfaces. 

The zApp Developer's Suite for X/Motif costs $2,995 
per developer and includes source for zApp and the zApp 
Interface Pack. The package is available for Solaris 2, 
SunOS, IBM AIX, HP-UX, SCO UNIX, SGI IRIX, Novell Unix- 
ware, and Sun Solaris x86. For more information, contact 
Inmark Development Corporation, 2065 Landings Drive, 
Mountain View, CA (415) 691-9000;fax (415)691-9099. 


DCX, PCX, and ASCII files. The product also includes a 
printer driver to create fax documents from any Win¬ 
dows application, along with a fax viewer and editor. 

VBFax prices start at $395 and include a 30-day, 
money-back evaluation period. For more information, 
contact PRONEXUS, 123 Pineridge Road, RR#3 Carp, 
Ontario, CANADA K0A-1L0, (613) 839-0033; 
fax (613) 839-0035. 
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Hyper Act Offers WinHelp Dialogs and WinExecf) Replacement 


XSpawn is a new DLL that replaces UinExecO with a 
set of functions that let you: detect when a spawned pro¬ 
gram terminates, detect the exit code of the spawned 
program, automatically support synchronized spawning 
under WIN-OS/2 and Windows NT, and detect termina¬ 
tion and exit codes of OS/2 and Win32 applications. The 
product comes with complete source code and header 
files and example programs for C, C++, Borland Pascal, 
and Visual Basic. 

IH is a new WinHelp DLL extension language that 
lets you add interactive forms and dialogs to your Win- 


Concentric Updates R8R Report Writer 

R&R Report Writer is a report generator that can be 
used to query, analyze, summarize, and publish data¬ 
base information. R&R can be customized and integrated 
with other Microsoft Office applications, and R&R reports 
can be embedded in Windows applications created with 
Visual Basic or C/C++. The new version includes ODBC 
drivers to access more than 25 database formats. A re¬ 
port dictionary and report templates let developers cre¬ 
ate simplified views of a database for end users. Report 
wizards are implemented via a new scripting language; 


MITI Introduces Universal Report Writer 

SQR3 Workbench is a universal production report 
writer that operates on multiple databases and across 
multiple platforms to create complex reports. SQR3 Work¬ 
bench is based on the SQR report writer, but adds multi¬ 
media-style graphics, enhanced portability, and more 
functionality. Business graphics that respond dynamically 
to database changes can be included in the new SQR3 re¬ 
ports. Images from video or voice can also be integrated 
in the report. You can store SQR3 reports on the client 
and execute them on the server for faster execution. The 
output of SQR3 is also portable, so reports can be dis¬ 


Help titles. Data in the forms can be connected to exter¬ 
nal databases using a dynamic dispatch function mecha¬ 
nism. The DLL lets you trap and handle WinHelp events, 
and automatically activate macros when the user enters 
or exits particular topics. 

1H costs $149. Xspawn costs $99. For more informa¬ 
tion, contact HyperAct, Inc, P.O. Box 5517, Coralville, IA 
52241; phone/fax (319) 351-8413; 
76350.333@compusetve.com. 


Visual Basic source code for the wizards is available sepa¬ 
rately. R&R's royalty-free runtime is accessible via a VBX, 
DLL, or as a Windows EXE. The product is available in an 
Xbase Edition and an SQL Edition. 

R&R Report Writer v6 costs $249 ($99 for an up¬ 
grade) for the Xbase Edition and $395 ($149 for an up¬ 
grade) for the SQL Edition. For more information, contact 
Concentric Data Systems, Inc, 110 Turnpike Road, 
Westboro, MA 01581, (800) 325-9035 or (508) 366-1122; 
fax (508) 366-2954. 


played on PC screens or terminals, printed on PostScript 
printers, or even distributed via e-mail. New functions in¬ 
clude print preview, online Windows help, and a simple 
graphical installation program. SQR3 can also print multi¬ 
ple reports from the same retrieval data, saving the ex¬ 
pense of multiple queries. 

SQR3 Workbench costs $500 for Windows (includes li¬ 
cense to distribute the SQR3 Viewer module) and $1,200 
for UNIX. For more information, contact MITI, 2895 
Temple Avenue, Long Beach, CA 90806, 

(310) 424-4399;fax (310) 424-9385. 


DemoSHIELD Provides Toolkit for Building Demos 


DemoSHIELD is a new visual demonstration toolkit 
for creating interactive software demos and tutorials for 
Windows applications. Using DemoSHIELD, developers 
can click and drag objects into scenes and then link indi¬ 
vidual scenes to form a presentation; no programming 
or scripting is required. Built-in features help you manage 
scenes, sub-scenes, and objects like bitmaps, text, and ba¬ 
sic graphic building blocks. Viewers can select the pace 
and content of the demo, using VCR controls. Edit fields, 
buttons, and hotspots all allow developers to create inter¬ 


active demos. The product includes a setup wizard to 
help create a distribution disk that will install and play 
the demo on the customer's system. 

DemoSHIELD costs $495, is royalty-free, and comes 
with an unconditional 60-day, money-back guarantee. 
For more information, contact Stirling Technologies, Inc, 
1100 £ Woodfield Road, Ste. 108, Schaumburg, IL 60173, 
(800) 374-4353 or (708) 204-9111;fax (708) 240-9120; 
CompuServe (CO STIRLING). 


CodeCheck v5.0 Automates Code Reviewing 


CodeCheck v5.0 is a software analysis program that 
helps automate software quality assurance. The product 
can "learn" your company's coding standards and then 
automatically check source code for compliance. The 
product reads all variants of C and C++ code and is avail¬ 
able for Windows 95, the Macintosh, OS/2, Windows NT, 
and UNIX. 


CodeCheck v5.0 costs $495 for Windows 95 or the 
Macintosh, $995 per user for OS/2 or Windows NT, and 
$1,995 per server seat for UNIX network environments. 
For more information, contact Abraxas Software, Inc, 
5530 SW Kelly Ave., Portland, OR 97201, 

(503) 244-5253; fax (503) 244-8375; abraxas@ortel.org. 
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Kaleida: Calling All Multimedia Developers 


Kaleida Labs, Inc. is now shipping the Kaleida Media 
Player and the ScriptX language and class library. The Ka¬ 
leida Media Player is a new software platform for interac¬ 
tive multimedia. ScriptX is an object-oriented dynamic 
language for creating applications for the Kaleida Media 
Player; the included class library gives ScriptX developers 
the base tools they need for common tasks. 

The company also announced new services for its 
Worldwide Developer Program. Members who purchase 
a Vanguard Annual Membership get one free 1995 soft¬ 
ware release, early software release, and a 20 percent 
discount on additional products, unlimited technical sup¬ 
port for two developers, one free training course, and a 


$400 discount on any course, access to co-marketing op¬ 
portunities, and other services. Members who purchase 
the Associate Annual Membership get similar services, 
but do not receive free or early software releases, or un¬ 
limited technical support for two developers. 

The ScriptX Language Kit costs $795; a license to dis¬ 
tribute Kaleida Media Players costs $2,500 per title. The 
Vanguard membership program costs $5,000 per year 
and the Associate program costs $1,000 per year. For 
more information, contact Kaleida Labs, Inc, 7 055 B 
Joaquin Road, Mountain View, CA 94043, 

(800) 6-KALEIDA or (415) 335-2098; fax (415) 335-2097; 
kaleida.direct@kaleida.com. 


UPData Provides Inexpensive User Profiling 


Cimulus, Inc. has released UPData, a new user profil¬ 
ing tool. When linked with your program, UPData can 
monitor users' actions, such as which options they select, 
in what order, and how often. Information is collected 
and logged to a compressed file without interfering with 
the user or your application in any way. The user can re¬ 
turn the log file to the developer for analysis. When used 


to track internal code warnings and errors, UPData can 
help show you exactly what user actions led up to the 
problem. 

UPData costs $79.95, which includes both DOS and 
Windows versions. For more information, contact 

Cimulus, Inc, 2901 Hubbard Road, Ann Arbor, Ml 48105, 
(313) 769-4108. 


COMM-DRV Packages Get Upgrade 

Willies Computer Software Company (WCSC) has re¬ 
leased COMM-DRV/LIB vl 5.0. This version contains on¬ 
line help and a revised manual. The Zmodem 
implementation now supports crash recovery, duplicate 
file renaming, and duplicate file deleting, as well as con¬ 
figurable time-outs and retry counts. The library now sup¬ 
ports any device that supplies an I NT 14h driver, such as 
modem pools, or any INT 14h redirector. This version 
adds support for multiport cards from GTEK and Boca Re¬ 
search. Modem strings are now configurable. Input 
stream scanning is now multidimensional and can be 


done destructively or non-destructively. Support is built- 
in for the WCSC high-speed VxD (COMM-DRV/VxD). 

COMM-DRV/LIB vl 5.0 costs $129.95, COMM- 
DRV/VxD costs $69.95, COMM-DRV/DOS costs $69.95, 
COMM-DRV/WIN costs $69.95, and COMM-DRV-LOG 
costs $99.95. For more information, contact Willies 
Computer Software Co. (WCSC), 2470 S. Dairy Ashford, 
Suite 188, Houston, TX 77077, (800) 966-4832 or 
(713) 498-4832;fax (713) 568-3334; 

BBS (713) 568-6401; sales@wcscnetcom; 

CompuServe: 75300,3427. 


AccuSoft Releases New Image Processing Kit 


AccuSoft is shipping Pro-Imaging Toolkit, featuring im¬ 
age processing and analysis support for 1 -, 4-, 8-, and 24- 
bit images. This DLL gives developers routines to access 
and modify Windows DIBs. Functions include chroma¬ 
key, region of interest processing, image analysis, image 
processing, color separation and combination, deskew. 


rotate and edge enhance, and clipboard support. The 
product includes source code examples. 

The Pro-Imaging Toolkit costs $795 for the 16-bit ver¬ 
sion and $1,495 for 32-bit Windows NT. For more infor¬ 
mation, contact AccuSoft Two Westborough Business 
Park, Westborough, MA 01581, (508) 898-2770; 
fax (508) 898-9662. 


Superbase95 Offers Object-Based Windows Database 


Superbase95 is the new object-based version of Su¬ 
perbase, the application development relational data¬ 
base management system for Windows. The new 
version features an object model with a Visual Basic-like 
language, progressive learning tools, multimedia and 
communications support, and the ability to run in 4Mb 
of memory. The object model supports more than 70 dif¬ 
ferent object types, including forms, reports, dialogs, com¬ 


munications, and mail. The language includes event pri¬ 
oritization and does not limit the number of controls on 
a form. The product still supports the previous language, 
Super Basic Language, so no conversion is required for 
existing Superbase application code. 

Superbase95 costs $295. For more information, con¬ 
tact Superbase, Inc, 80 Orville Drive, Bohemia, NY 11716, 
(516) 244-1570; fax (516) 244-0250. 
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ZipTip Gives Your App a "Tip of the Day" 



ZipTip is a standalone application that lets you add a 
WinWord-style Tip of the Day' feature to your Windows 
application. Each time ZipTip executes, it opens a dialog 
displaying a shortcut or product feature which the user 
might otherwise have missed. To use ZipTip, you create 
a text file containing a list of tips, one tip per line (up to 

2,000 characters). At the point you want the next tip to 

appear (such as at startup or via a Help menu selection), 
you launch ZipTip. 

ZipTip costs $49, and includes both 32-bit and 16-bit 
versions, but does not include a license to distribute Zip- 
Tip with your application. For more information, contact 

Responsive Software, 1901 Tunnel Road, Berkeley, CA 

94705-1762, (510) 843-1034; fax (510) 644-1013. 


Blinkinc Updates Linker 



Blinkinc has released Blinker v3.1, which offers incre¬ 
mental linking for protected-mode CA-Clipper programs. 
Blinker is a royalty-free DOS extender, a Windows and 

OS/2 linker, and DOS dynamic overlay linker. The prod¬ 
uct offers a dual-mode feature that lets programmers cre¬ 
ate a single program that automatically runs in either 
real or protected mode, depending on the runtime ma¬ 
chine's resources. This version provides protected-mode 
support for all Microsoft C/C++ and FORTRAN graphics li- 

braries, allows creation of Windows DLLs, adds OS/2 sup¬ 
port, offers dual-mode support with internal or external 
overlay files, and doubles the link time virtual memory 
capacity for larger libraries and EXEs. 

Blinker v3.l costs $299. For more information, con¬ 
tact Blinkinc, 8001 West Broad Street, Richmond, VA 

23294, (804) 747-3600 (support) or (804) 747-6700 
(sales);fax (804) 747-4200; BBS (804) 747-7333. 


Virtual Reality Toolkit Moves to NT 



WorldToolKit is a cross-platform virtual reality devel¬ 
opment tool, now available for Windows NT. Based on 
the OpenGL API, WorldToolKit provides texture-mapped 
real-time simulation. The software requires a Pentium 90 
or PowerPC 604 CPU, Windows NT, Microsoft Visual C++ 
v2.0, and 32Mb of RAM. WorldToolKit does not require 
an accelerator, but will support a variety of OpenGL accel¬ 
erator boards, including Freedom Graphics for the PC, 
from Evans and Sutherland. The system supports multi¬ 
ple I/O devices, including head-mounted displays and 
trackballs. WorldToolKit for Windows NT is compatible 
with other products from the company, including 

WorldToolKit for: PC-DOS, Windows 3.1, Evans & Suther¬ 
land Freedom Series, Sun SPARCstation ZX and 20 SC, 

DEC Alpha workstations, HP workstations, and all Silicon 

Graphics workstations. 

Pricing for The WorldToolKit for Windows NT starts 
at $2,695 for the software, with a mandatory first-year 
support cost of $540. Government and educational dis¬ 
counts are available. For more information, contact 

Sense8 Corporation, 100 Shoreline Highway, Ste. 282, 

Mill Valley, CA 94941,(415)331 -6318; 
fax (415) 331-9148. 


GUI Guidelines Updated 



GUI Guidelines v4.1 for Windows is the latest version 
of an online help system for user interface development. 

GUI Guidelines provides a database of text and graphic 
examples to help teach user interface design principles. It 
provides rules and recommendations to help corporate 
developers create consistent GUI applications. Templates 
included with the package provide a starting point that 

developers can customize to quickly design interfaces for 
common situations. 

GUI Guidelines v4.1 for Windows costs $395 for a sin¬ 
gle-user license, $2,995 for a 10-user license. For more in¬ 
formation, contact Corporate Computing, International, 

2549 Waukegan Road, Suite 108, Bannockburn, IL 

60015, (708) 374-1995;fax (708) 374-1124. 


GUI Repository Enhances SQLWindows 



GUI Repository is a new tool that offers project man¬ 
agement and quality assurance features to Gupta 
SQLWindows developers. A standard repository stores 
module-level objects as BLOBs in SQL databases and 
maintains the relations between these objects. GUI Re¬ 
pository additionally can recognize the constituent ele¬ 
ments in these objects, and store them together with 
their relations. Developers can access and view informa¬ 
tion down to the level of detail of instance object proper- 

ties. GUI Repository offers reporting facilities on all of the 
code, version control at the element level, and online 
class browsing. 

GUI Repository costs range from $6,850 for the five- 
user 5tandard Kernel edition to $22,500 for the GUI Re¬ 
pository with extensions for unlimited users. For more 
information, contact Altair Automation, One Rockefeller 

Plaza, Suite 1420, New York, NY 10020, (212) 265-6794; 
guirepo@a1tair.nl. 
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Readers' Forum 


Mr. Burk, 

Thanks for the excellent publication, Windows/DOS De¬ 
veloper's Journal I I've tried to keep up with each issue, but 
find as often as not I forget to buy them. I notice way 
back in the July 1994 issue your inclusion of SDK annota¬ 
tions. To date I've missed most of them. Have you 
thought of making them more widely available? Having 
them in the magazine is excellent. However, not everyone 
receives the magazine and this information is valuable. 
Thanks again for the excellent magazine and a happy 
holiday to you and the staff. 

Sincerely, 

Robert Bateman 

Thanks for the compliment! We probably need to find a way 
to make it clearer, but the SDK annotations are distributed (both 
in ASCII and .ann format) with the code disk. The table of con¬ 
tents lists the main locations where we distribute the code disk; 
hopefully, one of those (CompuServe, anonymous FTP, etc.) is 
accessible to you. -rib 


Ron, 

As a matter of fact, Steve Maguire's book Writing Solid 
Code contains some very good suggestions for writing 
solid code. While it's easy to take potshots at Microsoft, 
how many non-trivial applications have you written that 
are bug-free? 

All that aside, 1 find your book reviews quite useful and 
frequently entertaining as well. Keep up the good work; 
it's a jungle out there! 

Frank Brown 

Bamboo Software (not affiliated with Microsoft) 

You refer to my rhetorical editorial question "Is anyone really 
buying these books that claim to reveal Microsoft's secrets for 
writing good code?" As an example, I cited Maguire's book, the 
subtitle of which is " Microsoft's Techniques for Developing Bug- 
Free C Programs." Well, I've written as many bug-free applica¬ 
tions as I claimed to have: zero. What I meant to criticize with 
my editorial remark was both the tendency to make outrageous 
claims on book covers and the idea that Microsoft's strength is 
producing high-quality code or software designs. Also, I have 
heard of at least one case in which a publisher decided to pub¬ 
lish a book of poor quality against the advice of its technical 
advisers, mostly because the author worked at Microsoft. At the 
risk of being a Microsoft basher, my opinion is that they pro¬ 
duce about as much inferior code (and books) as any other soft¬ 
ware or book publisher. Therefore, my eyebrows always go up 
when I see employment at Microsoft used as a selling point for 
a book on software. 


Writing Solid Code is one of those books I like somewhat, 
but not necessarily for the purpose the author intended. I think 
the book is anecdotal and inspirational, a light, easy read that 
leaves you feeling comfortable - kind of like a slice of pie a la 
mode. There's absolutely nothing wrong with that, it can be 
worth some bucks to be entertained and get psyched up to write 
better code. I didn't find much good information here that has 
not been covered by other books long ago, but perhaps the 
author was unaware of the classics on programming - he cites 
very few of them as references. In any case, the anecdotes and 
writing are all fresh, and that is really the book's strength. 

On the other hand, to some extent, the price for being enter¬ 
taining and inspirational is providing pat answers, which can 
only carry you only so far in programming. For example, on 
page 88, the author critiques the design of the C function 
getchar() (it returns an integer not a char, returning a negative 
value for end-of-file, which can cause problems), saying "But re¬ 
ally, is there any reason getchar() should be so hazardous?" Ac¬ 
tually, there are reasons, but the author probably did not have 
the historical experience to know them. First, back when 
getchar() was designed, int and char were much more closely 
related; only over time and ANSI standardization has char be¬ 
come a more full-fledged data type. Second, C was designed 
when the only widely portable language was Fortran. Fortran 
was justly famous for its inefficient I/O, and the C I/O package 
was intended to offer efficiency. Due to its “unsafe design," I 
have seen implementations of getcharO that execute nearly as 
fast as a couple of pointer dereferences. Sometimes, the real 
world calls for sacrificing clarity for efficiency and vice versa - 
deciding which situation you have in front of you is part of the 
messy side of programming. Also, the best design for today may 
not be the best design for 10 years from now; trade-offs change 
over time. 

I typically don't recommend Maguire's book to people, not 
because it is bad, but because there are always folks who want 
to use the latest book as their programming "bibie." Instead, I 
recommend Steve McConnell's Code Complete. It is more rig¬ 
orous, more complete, has much more thorough references, 
and generally seems to have been written by someone with 
more breadth and depth in the field of programming. It is not, 
however, as entertaining or inspirational as Writing Solid Code, 
nor is it something you can breeze through in a few hours. 
Someone could still choose to make a programming religion 
out of it, but at least Code Complete has fewer pat answers for 
such folk to hang themselves by. 

Thanks for your feedback. Although, strictly speaking, you 
were disagreeing with my inflammatory editorial remarks rather 
than a book review, I hope more readers will send in their dis¬ 
senting or alternative perspectives on books discussed in 
W/DDJ. There is no one right opinion about books - someone 
dearly loves even the most widely hated tome, and someone 
loathes even the most universally praised text! -rib 
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Developer's 

Marketplace 


Development 

CD-ROMs 


Absolutely the World’s largest, best indexed and 
most current collections of technical shareware 
CD-ROMs for professional programmers since 
1984. Priced from $25. Database (DBF) directories 
describe all products on CDs in detail, and include 
information on all commercial tools as well. Up¬ 
dated at least every two months. 

We have CD-ROMs with 546 MS-Access prod¬ 
ucts, 624 Assembler files, 1891 C/C++ files, 846 
C++ only, 1277 AutoCAD, 3131 Clipper, 2059 
FoxPro/Dbase, 2009 NetWare Utils, 741 OS/2 
Utils, 505 Spreadsheet Utils, 964 Paradox, 1218 
Pascal, 458 Scientific, 299 VBDOS/QB/PDS, 
1124 Visual Basic, 1015 Windows Utils and a 
205,000 record database of PC products. 

EMS Professional Shareware 
4505 Buckhurst Ct.; Olnev, MD 20832 
Voice:(301)924-3594 Fax:(301)963-2708 
E-Mail :eengelmann@worldbank.org 
http://xmission.com/~wwwads/ 
ems/ems.html 


□ Request Reader Service #112 0 


WINDOWS DEVELOPERS 

I specialize in finding permanent and 
contract opportunities for Windows™ 
Developers. The market is excellent for 
talented software engineers. Focus on 
recruiting for Colorado and nationwide 
positions. All fees paid by the company. 
Give me a call at 1-800-638-8903. 

— Gary Patton 


THIS IS YOUR FUTURE 


JpAREER 

MARKETING 

0SSOCIATES 


□ Request Reader Service #106 □ 


Add Rule-Based 
Logic to Your 
Windows oosApps 

Use the power of Prolog rules to add 
diagnostics, advice, automatic tuning 
& configuration, and much more to 
your C/C++, Visual Basic and other 
Windows & DOS programs. Full 
Prolog development system with 
Logic Server™ API (LIB and DLL). 
$298, no royalties. 

FREE CATALOG! 

Amzi! inc. 

40 Samuel Prescott Drive 
Stow, MA 01775 U.S.A. 

508/897-7332 fax-2784 
amzi@world.std.com 


Cogent 

The Programmer's 

Prolog 
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Opt-Tech Sort/Merge 


^ New -Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 


Opt-Tech Data Processing 

P.O. Box 678 
Zephyr Cove, NV 89448 

(702) 588-3737 J 
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The best embeddable 
macro language... 


C DIt/ 


is completely compatible with Visual Basic, 
offers such VBA features as keyword 
parameters and With statement, 
supports full OLE 2.0 automation. 

provides direct 
access to C++ objects; 
supports polymorphism 
’ single inheritance, 
is application-extensible through functions, 
objects, datatypes, variables, constants, and 
application dialog boxes, 
includes an Editor/Debugger, an integrated 
Dialog Box Editor, printed and on-line Basic 
documentation — all fully redistributable to 
your end users. 

The Editor/Debugger offers breakpoints; step 
into, step out of, step over; watchpoints; 
expand/contract; structures; arrays. 

— • The Dialog Box Editor features 
J£—■ drag and drop, multiple selection. 

Mystic River Software, Inc. 

125 CambridgePark Drive • Cambridge, MA 02140 

)•••••••••••• 
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Free CDROM! 


Sampler CDROM: You get useful sam ples from 
44 CDROMs + $5.00 check inside-EHOS 

•Free with regular $5.00 shipping charge _ 

Cica MS Windows: 2-disc set! 4000 new $29.95* 
prgrms, games, utilities, drivers, code, fonts. 

Simtel MSD0S: Now 2-disc set! 1000 MB $34.95* 
MSDOS shareware (utils, games, code, etc.) 

Hobbes OS/2: OS/2 Mag's Product of the Year! $29.95* 
600 MB of OS/2 Share/Freewure (2-disc set). 

C Users' Group Library: C Users'Journol $49.95* 
Archive: 10 yrs of C code & articles 
Source Code : 650 MB C, Usenet Unix, DOS $39.95 
Toolkit lor Linux: Slackware 2.0 32-bit 0/S $39.95 
for PC with GNU & XI1. Src. [2-disc set!) 

FreeBSD 2.0: Berkeley BSD, 32-bit 0, 

PC, with GNU & XIL Full source. 

Internet Info: 12,000 computer, network 
Internet documents. FAQ's, RFC's & lEN's 
Space & Astronomy: Thousands of NASA 
images -+ viewer, 5000 data files, prgrms. 

♦shareware requires separate payment to authors if found useful 

Call Now tor our Free Catalog! 1-800-7 86-9907 

Walnut Creek CDROMIE E3H 
1-510-674-0783 - FAX 1-510-674-0821] 
email: orders@cdrom.com 
4041 Pike Lane, Suite D-692 Concord, CA 94520 I 692 


6/S for $39.95 
$39.95 
$39.95 
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Albin Engineering Services, Inc. 

"'founded by engineers for engineers" 
Albin Engineering Services, Inc. is a fast 
growing contracting agency and recruiting 
firm providing contract and permanent 
placements in the South San Francisco Bay 
Area. 

• WINDOWS: MS Windows, DOS, Real¬ 
time, C++, Visual C++, VME, NT 

• SOFTWARE TESTERS: MS Windows 
applications, MSTest, Client/Server, 
Database, NLMs, Novell Netware 

• UNIX SYS ADMIN: Solaris, Novell, Mac, 
OS/2, DOS, Windows, TCP/IP, IPX, XNS 

• PROGRAMMERS: Active EBI, C, C++, 
FORTRAN, UNIX, VMS, Oracle 

• INSTRUMENTATION: Senior level 
technical consultant responsible for sales 
and new office startup, RF, Embedded, C, 
UNIX, VME/VXI (Phoenix, AZ) 

540 Weddell Dr., Suite 9 • Sunnyvale, CA 94089 
FAX: (408) 747-1959 


MGSpell V2.0 

120,000 word dictionary 
Spell Checking/Corrections 
User Dictionaries 
WIN/DOS and Mac Versions 
Use Win version with any DLL compat language 
DOS Version works with C/C++ 

MGSPELL V2.0, Item 11359, $99 

Display-Gif 

Add FULL-Color GIF Display/Import 
Great For Title/Info Screens 
Uses ONLY BGI Function Calls 
Includes SuperVGA(VESA) BGI Driver 
For use with Borland C/C++ only,full source code 

VIEW-GIF, Item 11450, $50 

To order call PSL: 

1-800-242-4775 ( 713 - 524 - 6394 ) 

Order by item number, this 
number is for orders only. 

For more info contact: 

1-800-270-1394 ( 314 - 638 - 2506 ) 

76476.1701 @compuserve.com 
MicroGenesis Software,P.O. Box 25534 
St. Louis, MO 63125 
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Sb: WDDJ Book Review 
Fm: Bill Allen [71541,764] 

Ron, 

I really enjoyed your book review in the January '95 
issue, and find it a very valuable service. 

Thanks! When you come across a good book or a real 
stinker, drop me a note and let me know, -rib 


Sb: Books overview 

Fm: Len Belyakov [73662,2651] 

Hello, Ron. 

Just received the new issue of W/DDJ. I really liked 
your book review ("Books in Brief). The value of this col¬ 
umn could not be overestimated and here's why: I do buy 
(and even read) a lot of books. Because of the sheer vol¬ 
ume of what's available, it's not easy to pick a really good 
book, so I mainly go by the author - anything from Schul- 


man's series, Petzoid, Swan, Richter, Yao, Meiers, Flamig is 
likely to be good. However, sometimes the topic of inter¬ 
est isn't really covered widely (and I'm going to make an 
example), so you get what you can - and it is extremely 
frustrating to realize that for your $30-60 you've got a 
piece of garbage and nothing else is available. 

Examples of the sought-after topics that are absolutely in¬ 
adequately represented are OLE 2 and Windows device driv¬ 
ers. It would be just great if you could comment in your 
magazine on the MS Press-generated suite of manuals for 
OLE 2 (especially Brockschmidt's Inside OLE 2). These books 
are so insultingly badly done (zillions of typos, bad program¬ 
ming, bad English, the books are not edited, or even proof¬ 
read) that it'd be quite appropriate to ask for a comment 
from MS Press. Another topic is Windows device drivers - 
the books are few (two, to be exact - one by Norton and 
another by Thielen - both are very lame). Basically, they 
reprinted the DDK and added typos. If you don't know how 
to write drivers, you won't learn from these books; if you do 
know, well, then you don't need them. 
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“I wish this was a 
Windows Application” 

You need the power and simplicity of 
ClearWin+™ with Salford’s 32-bit C++ 
compiler for DOS, Windows 3.x and 
Win32 (Windows NT and Chicago). 
Using formats, ClearWin+™ offers an 
innovative approach to the problem of 
producing maintainable Windows code. 
Write a realistic prototype quickly in less 
than 100 lines of code with no previous 
Windows programming experience! 


ASK FOR A FREE 
, DEMO DISK 
TODAY 


Adelphi House, Adelphi Street, Salford M3 6EN, UK 
Tel: (+44) 0161 834 2454 Fax: (+44) 0161 834 2148 
Fax toll free from USA: 1 800 562 6875 
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Salford 

cSo/iuYiie 


Add ZIP (and UNZIP too!) to 
your Windows applications! 


fDynaZIP 

I Data Compression Toolkits 


The ROYALTY-FREE DynaZIP family of 
developer's tools let you read, test, 
create, write, and update industry 
standard ZIP files directly from your 
Windows-based products. No more 
"shelling" to DOS, and no more fussing 
with proprietary compression formats. 
Fast, easy to use, and totally reliable! 
Versions for C/C + + , Pascal, VB, 
database, 16 and 32 bit. 


Fully Supported, 
w/30-day no-risk guarantee! 
Call today, toll free: (800) 962-2949 


Inner Media, Inc., Hollis NH USA (603) 465-3216, fax (603) 465-7195 
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Phone Sound: Simple! 


For Windows/DOS Voice Mail & Fax Developers 



Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


1. Create fantastic prompts 
and save time with VFEdit®' 
Record, crop, cut, copy, paste, 
mix, fade, echo, volume & 
more with your Dialogic™ 
D4x/12x boards. 

2. Add Voice Mail power to 
your MS Windows apps with 
TI/F DLL ™ our Tel I/F 
Dynamic Link Library. 

3. Audio Tool Box ™ 
converts to and from 


Multimedia Wave (16, 8 & 
MS ADPCM), linear 16 & 
unsigned 8, plus Dialogic 4 & 
8 at any sample rate! 

4. Scribe Transcription 
Utility for DOS plays digital 
audio files in the background 
without voice mail hardware! 

5. Add Text-to-Speech 
capability to your apps with 
VoxFonts ™, our "software 
only" text-to-speech library! 


Order Now! 1-800-234-VISI 


(Voice Information Systems: 24 N Mcrion Ave, Bryn Mawr, Pa 19010 I 
Tel:215-747-5035/ BBS 310-392-6610/ Fax: 1-800-234-FXIT | 
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DICE IS LOOKING FOR... 


...data processing, engineering and 
technical writing professionals to fill 
open positions nationwide. DICE is 
a FREE online job search service 
providing detailed information about 
current contract and full-time 
positions across the USA. It’s a 
confidential, easy to use, no cost 
way to search for a new job. 



DATA PROCESSING 
I NDEPENDENT 
CONSULTANT’S 
E XCHANGE 


ONLINE Number 
515 - 280-3423 


Contact DICE via 1200/14400 baud 
Modem, 8-N-1. 

A service of D&L Online, Inc. 
515-280-1144 
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Bar Code Fonts 


If you write enough applications, 
sooner or later you’re going to have 
to print bar codes. And what could 
be easier than calling a font? 

Azalea Software, Inc. specializes in 
quality bar code printing tools. Call 
us today to see how much fun bar 
codes can be. 



azaljsa 

software inc. 


Azalea Software, Inc. 
8 oo 48 -ASOFT 
206 932.4050 
azalea@igc.org 
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Our editor has speed, 
a complete macro language, 
configurability, large file handling, 
compiler automation, and 
colorization. Cost? $89.95 for 
Windows, $129.95 for Windows 
NT. See for yourself. Download a 
demo copy. 

Try a complete, free eval copy tonight! 

BBS: 206-935-5198 
AOL: WindowWare 
CompuServe: WINAPA, Sec. 15 
FTP: www.windowware.com /wwwftp/wilson 
WEB: http://www.windowware.com/wilson/pages/ 
Orders: 1-800-938-4599 
Wilson WindowWare, inc. 
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1 - 

I Does your company 
provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 22,000 
serious programmers in: 

Windows/POS 

□ DEVELOPER'S JOURNAL 

Call 913-841-1631 today for 
information about 
advertising opportunities in 

Windows/DOS Developer’s Journal. 

Advanced. Serious. 

Technical. 


I Brian Osborn - Continental Europe. 

+49 431-396895 

I Ed - East I Christine - Midwest I Edwin - West 
913 - 841-1622 1913 - 841-6733 1913 - 841-1626 


NO BLACK MAGIC ! 


Universal Synchronized Spawn 
for Windows Applications 

The XSpawn library replaces the Windows 
WinExec function with a set of functions that 
allow you to: 

* Detect when a spawned program terminates 
and it's exit code 

* Automatically support synchronized spawning 
under WIN-OS/2 and Windows NT 

* Detect termination and exit code of OS/2 
and Win32 applications 

* Manual status polling 

* Operating system & executable type detection 

All this with a simple API - 
no VxD, no callbacks, no black magic for $99 ! 

Includes header files and example programs 
for C, C++, Borland Pascal and Visual Basic. 
Full source code is included. 

Price does not include S&H. ©Copyright 1994 of Yaniv Golan 

P.O.Box 5517, Coralville, IA 52241, US A. 
TeleFax. (319) 351-8413. CompuServe 76350,333 
Internet: rloewy@panix.com 
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IMWHelp 


UJindouj/ Help Authoring Tool 


Professional quality help files 
in 1/4 the time!! 

• Edit text directly in IMWHelp 

• Build hypertext links to: topics, 
definitions, subjects 

• Glossary automatically created 

• Bitmaps incorporated 

• Desktop publishing features 

• Print topics, help file, customized 
reports 

• Spell check, replace verify/all 

• Easily reorganize topics, subjects, 
keywords 

• Uses Microsoft Help Compiler 

Single User: $89.95 

MC & Visa accepted, Shipping additional 

Call: IMCSI (212)319-1903 

425 Madison Ave., New York, NY 10017 
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Unique Custom Controls 

We've got the controls everyone else 
missed. Why buy yet another package 
with a bound text box when you can 
get more? 

Our controls are easy-to-use, solid, 
and royalty-free. Free lifetime updates 
from our BBS. Source code and site 
licenses are available upon request. 

There are too many to mention here, 
so write, call, or fax us for a product 
list. Or, send us $5 for a sample disk. 



Mabry Software 

Post Office Box 31926 
Seattle, WA 98103-6925 

Voice: 206-634-1443 
Fax: 206-632-0272 
CompuServe: 71231,2066 
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WINDOWS DEVELOPERS! 


Text-to-Speech 
Speech Recognition 
Speech Compression 


Software Development Kits 
now available for Windows 3.1 ! 


Set your products apart! 
Speech is the ultimate user-interface! 


& 


LERNOUT & HAUSPIE 


PRODUCTS 


ISPEECHl 


800 W. Cummings Park, Suite 3100, Woburn, MA 01801 
(617) 932-4118 x202 Fax: (617) 932-9209 

(800) 252-4999 x202 

CALL FOR MORE INFORMATION 
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C and C++ DOCUMENTATION 


!! NEW VERSION 6.0 !! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59)Counts path complexity, 
counts comments, code, 'C' statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($69) Creates cross-reference of 
local/global/define/parameter identifiers. 

• C-DOC ($199) PACKAGE All 5 programs 
integrated as DOS program (<10,000 lines) 
V6.0 C-BROWSE Windows graphic-tree viewer. 

. C-DOC Professional ($299) DOS, Windows 
OS/2. 3-ring binder/case. <1,000,000 lines 

• 30-DAYMoney-back guarantee CALL NOW 

SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga , „„ 
ONT, Canada Voice/Fax (905V-858-4466 
^f^M^^^Demo/BB^905^858J9TF 
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Tools for Novell’s Btrieve-- 

BsupportHI Bsupport II 

lied it 3.0 - Btrieve file viewer/editor. 

Iianalyze 2.0 - Btrieve app. debugger. 

Brun 2.2 - BLITIL replacement plus source. 
Bcreate 2.0 - file creation utility. 

Bclicck 2.0 - Btrieve file analyzer. 

Xsupport 1.0 - build data dictionary 
(.DDF) for Access, OV, 
Crystal Rpts. 

Xport 2.0 - export/import CDF, SDF, 
dBASE. 

Call for information on additional 
products and FREE demo! 

Inronnalion Architects, Inc. j’i 1: I K00;i 359-2721 
3130 Pine Tree Road (517) 887-8000 

Lansing, MI 48911 Fax: (517) 887-2366 
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Prepare for the Lotus Notes 
Certification Tests. 


Lotus Development and Drake 
International charge $270-$450 to 
get certified on Lotus Notes. Isn't 
it worth $45-$60 to prepare? 


Consultant, 
Application Developer, 
Server Administrator PreTests 
(over 480 questions) 
cost just $45 each 
or buy the Specialist PreTest 
(over 720 questions) for just $60. 

These Lotus Notes databases allow 
you to take and grade the Pre Tests as 
many times as you want or need to. 


Send check or money order to: 

Reality Bytes 

28 South Main Street 
Randolph, MA 02368 
(Please share this ad with a friend.) 
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Today, the mere presence of programming literature is 
no longer an issue - the quality still is (and maybe even 
more than before, due to the number of new technolo¬ 
gies). 

You are right about the paucity of books in specific areas, 
like VxDS. I worry that this may be a case of early but inferior 
books discouraging authors and publishers from tackling the 
topic. Schulman's Unauthorized Windows 95 has appreciable 
information relevant to VxDS, but teaching how to write VxDS is 
not at all the point of the book. Karen Hazzah has a book com¬ 
ing out soon on writing VxDS for custom devices; I provided 
some editorial feedback on drafts of that book, so I will let oth¬ 
ers pass judgment on its usefulness when it arrives. 

My opinion of Brockschmidt's OLE book has risen slowly 
over time. As someone else mentioned, the book contains out¬ 
rageously uninformed discussions of things like why inheritance 
is “bad"; eventually, I learned to skip over those pages without 
grimacing. There is something to be said for actually slogging 
through the interfaces and building samples that (while they 


may have problems and sometimes encourage poor OLE prac¬ 
tices) actually function. I also came to believe that the small por¬ 
tion of the OLE specification that deals with COM is not too bad. 
As with every Microsoft specif cation, it falls very far short of 
completely specifying the software's behavior (that's why ANSI 
standards, despite the hassle, are a Good Thing). However, by 
flipping back and forth between Brockschmidt's book and the 
OLE specification, I've been able to slowly understand COM and 
how to make my own COM objects. Clearly, the Great American 
OLE book has yet to be written, though, -rib 


Sb: Bug++ of the Month, Feb. 95. 

Fm: Ayhan Tuncay [75113,3423] 

Dear Mark Nelson, 

Thank you very, very, very much for your Bug++ arti¬ 
cle in W/DDJ’s Feb. 95 issue. It answered one of my long¬ 
standing questions, and confirmed my suspicion about this 
Borland bug. I ran across the same bug about one year ago 
in my OWL1 project. After one week of trial and error, I 
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Marketplace 



Spend your time writing your App 
...Not wading through 
DDK documentation!! 

Hardware control for Win32™Apps 
-without the Device Driver Kit 
✓ Port I/O 

✓ Memory I/O 


Ask us about Alpha™. Power PC™ and 
Chicago versions. 

Blue Water Systems 



□ Request Reader Service #127 □ 


Diskette I/O 

Code Libraries 
Device Drivers 

VxDS 

Special Hardware 


Software for Conversion, 
Duplication, Analysis, 
and Data Recovery 


WE SPECIALIZE IN "ALIEN" 
NON-PC FORMATS. 

Write or call for a product brochure! 

W' V Tg\ PY PO Box 5700 
k_7 Y vJ-V^zY Eugene, OR 97405 

(800) 43-SYDEX or (503) 683-6033 
FAX (503) 683-1622 
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NOW IN EUROPE 


FOR ALL EUROPEAN SOFTWARE VENDORS 

In order to serve our European advertising 
customers better, Windows/DOS Developer's 
Journal now has a European Advertising 
Representative located in Germany. 

Now it is even easier for you to reach over 
22,000 experienced Windows programmers 
worldwide with an advertisement in 
Windows/DOS Developer’s Journal. (U.K. 
customers: please call Ed at 
01-913-841-1622.) 

Windows/DOS 

tl DEVELOPER'S JOURNAL 

Advanced. Serious. Technical. 

Brian Osborn 

breakout! marketing 
Friedrichsorter Str. 7 
D-24159 Kiel 
Germany 

Phone: +49 431 396895 
FAX: +49 431 396827 


Wouldn’t it be nice to make your 
product known around the world? 
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GUI Genius Wanted 


Legent Corporation must expand its staff to 
achieve its goal of World Domination. We 
have an immediate need for a talented GUI 
developer. 

We are looking for a Senior GUI Developer to 
help us provide a world-class interface for our 
cutting-edge distributed systems management 
product. If you are Goethe of GUI, the 
Michaelangelo of Windows, and the Vincent 
Van Gogh of Visual C++, we want you! 

For this special individual, we offer the 
opportunity to work with other high-bandwidth 
software professionals in a smoke-free, 
suit-free, and politics-free environment. For 
immediate consideration for this historic 
opportunity, please mail, FAX or E-mail 
something about yourself, your SAT, ACT, 
and/or GRE scores are also desirable, and 
your current salary to: 

Legent Corporation 

C/O: Barbara Buckle 

6200 Savoy Drive, Suite 440 Houston, TX 77036 
FAX: 713-974-0569 
73370.2530@compuserve.com 

Please do not call us or visit us. 

Legal ability to work in the US required. 

Legent is an equal opportunity employer. M/F/D/V 
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SOURCE CD ROM’s 

LANGUAGE/OS 

LARGEST collection of Source for 
Compilers, Libraries, & Docs for 
computer languages and OS on CD.... 
$34.95 (updated) _ 

LANGUAGE/OS II 

LARGEST collection of Source just 
got bigger!! A perfect companion to 
Language/OS, with more source for 
compilers, function libraries, and docs 
for standard and research 
languages & OS .... $34.95 

*****Btiy both for only $64.95***** 

KNOWLEDGE MEDIA Inc. 

(800) 78 CD ROM (916) 872-7487/FAX (916) 872-3826 
VISA and MASTER CARD accepted 
436-B Nunneley, Paradise, CA 95969 USA 
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1 - 800 - 775-1073 



New Version 3.0 


Never shell out to 
the O/S again! 
Crusher is a robust 
set of functions 
which provide 
your DOS, 
Windows, OS/2 
and Unix apps high 
performance, portable 
data compression. 


DOS Libraries $199 

DOS Libs w/source code $249 

Windows DLL $239 

Windows DLL w/source code $299 

Unix Portability Package $349 

Visa, MasterCard, American Express and Discover Cords welcome. 
Tel (606) 268-1559 Fax (606) 266-0726 j 


24-hour information by fax 
1-800-234-0141, doc #1151 
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PROGRAMMERS... 

$100k/yr at HOME! 


My new book, "How To Make $100,000 A 
Year And More Developing Low Budget 
Software Products", will reveal all the 
marketing tricks, strategies, and systems that 
have my business exploding with PROFITS! 

Add your skills to my proven strategies and 
you have the PERFECT BUSINESS ... Low 
overhead, part-time, home-based, huge 
margins, and UNLIMITED POTENTIAL . 


CALL 800-364-4883 


Call TODAY for a FREE special report! 
ULTRA _ Fax: 214-724-0375 

Fintmial lystomi CompuServe: 71223,634 

1633 Arrowhead Dr, Flower Mound, TX 75028 
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ABSOLUTELY, 
POSITIVELY, 
NO MORE 


vls T iHQ 

E r rO r S 


9 



$5/disk, 

one issue per disk 
or ALL of 1993 
or 1992 for $20! 


Call today! 

913 - 841-1631 


FAX 913-841-2624 


Windows/POS 

D DEVELOPER'S JOURNAL 


Suite 200 

1601 West 23rd Street 
Lawrence, KS 66046 


Add features to your 
Windows help files! 


The Help Browser lets you add vital 
features to any Windows 3.1 help file: 

An interactive map 
Full text search 
Multiple topic printing 

A developer’s license for the Help 
Browser is just $179 royalty-free, and 
it’s very easy to use! For details, call 
Cascadilla Press at (617) 776-2370. 


^Er 




Cascadilla Press 

Box 440355, Somerville, MA 02144 
(617) 776-2370, fax: (617) 776-2271 
e-mail: info@cascadilla.com 
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NT Hardware Interfacing 


The WinStar Hardware Classes 

MFC compatible C++ classes for 
harCware access from Windows NT 
applications. 

* Port and physical memory classes 

* Support for interrupt handlers 
o Hardware Viewer utility 

» Unlimited redistribution license for apps 
« Only $399 

Hardware Viewer 2.0 for NT 

GUI application for interacting with ports, 
memory and interrupts. Gredt utility for 
onyone working with hordwore. $149 

WinStar Technologies 

(415) 647-2815 
CompuServe: 74367,1 773 
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Visual Basic 

TRAINING VIDEOS 

Presented by J. D. Evans, Jr. 

Fundamentals of Visual Basic #1 

is Ihe frsl video in the series, Topics include an introduction lo VB, a history 
ol VB, diagramming techniques, programmer's responsibilities, and user 
interlace design. (90 min.) 

Fundamentals of Visual Basic #2 

topics include naming conventions, the event model, code practices, 
structuring code, and dbgamm'ng techniques. Special attention is 
given lo event model programming, (90 min.) 

Each video is $ 129. 

Get both videos for $ 199. 

Plus S&H. PA Residents add Sales Tax. 
30-Day Moneyback Guarantee. 

ETN CORPORATION 

RR4 Box 659 

MONTOURSVILLE, PA 17754-9433 
Tel: (717)435-2202 Fax: (717)435-2802 
CompuServe: 73641,242 
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X.25, SDLC, HDLC, FRAME RELAY, 
BSC ON THE PC 

Use the Sangoma SDLA card to 
provide synchronous support for your 
product that is cost effective, compliant, 
full featured, rock solid and easy to use. 

• Line speed to 180kbps 

• Compatible with all operating 
systems and environments 

• Operating statistics and built in 
datascope make your product easy 
to configure and debug 

• Primary and secondary SDLC with 
multiple addresses 

• HDLC LAPB, LAPD, NRM mode 

• CCITT 1988 X.25 implementation to 
ISO 8208 

SANGOMA Technologies Inc. 

Your communications Link 
Tel: (905) 474-1990; (800) 388-2475 
FAX: (905) 474-9223 


Dr. DeeBee M 
ODBC Tools 

Tools for ODBC development 




Ever wonder why your 
ODBC app is not 
working? Why it’s just 
too slow? If the ODBC 
driver is OK? 

Use Dr. DeeBee Tools 
lo find out. 


Dr. DeeBee utilities (Check, Peek, Timer, Test, Spy, 
Replay and Info) reveal the inner workings of ODBC. 

Dr. DeeBee: The smart way to do ODBC. 


-snw/n - 

PO. Box 91 Kendall, Cambridge, MA 02142 
B17- 497-137G Fax 617-497-8729 
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found the workaround: Turning the "jump optimizations" 
off (at that time I didn't see any connection to the 386 
code generation option that I was using). Since then 1 shy 
away from that particular option with a deep fear. How¬ 
ever, I didn't have time to get at the root of the evil as 
Mark Baker did (God bless him), because my program was 
crashing after 1 popped up two nested dialog windows; I 
was also using semi-kosher file access functions defined in 
io.h, some of which were not restoring the stack, as I was 
able to track in Turbo debugger. So it was kind of compli¬ 
cated to track the bug and prove its existence to Borland, 
so I let it go. (I guess proving a bug to Borland doesn't 
make whole a lot of difference, as Mark Baker's experi¬ 
ence shows). 

I compiled and ran the code example in your article. I 
have the following comments: 

(1) I couldn't generate the bug when I compiled and 
ran the code using my BCC version 4.02! But then I added 
-v (debug info) option, and that did the trick. I tried back 
and forth several times, without the -v switch, the code 


seems to be running fine. I don't know if you tested the 
code with a different version. 

(2) In your article, one fine point is not clearly stated 
but can be misleading to non-Borland users (or Borland 
users who never use command-line compiler): -O switch 
only stands for 'Jump Optimizations'. It is one of the 
many optimizations the compiler can perform. All others 
seem to work fine with this case. For example, you can 
turn on several other optimizations, but if you just turn off 
the jump optimization (e.g., -02 -0-), things work OK. 

Again, thanks a lot for the article. Keep up the good work. 

Ayhan Tuncay 
Mesa, AZ 

Thanks for the additional info on this bug. I think we all 
have run into compiler bugs and not had the time and determi¬ 
nation to track it down and try to present it to the vendor. One 
bug per month may not make a big dent , but it's better than 
nothing! -rib □ 
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S/W ENGINEERING POSITIONS NATIONWIDE 


When the country's 
top firms look for 
the best develop* 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows. NT, OS/ 
2 and Macintosh re¬ 
cruiting nationwide. 
So if it’s time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace forthem... 
we understand you. 


« Bateman Inc. 

5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax:310-641-2900 


We Understand 
Programmer’s 
Mind . 31 
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ProEssentials™ vl .5 





For... 

Visual Basic. 
Visual C++, 
Gupta. 
Clarion, 

and others... 

El Impressive Quality 
El Full of Features 
El Easy to Implement 


Windows 3.1 DLL / VBX providing three interactive 
controls: Graph, Scientific Graph, and Pie Chart 
objects. Ideal for information-system, financial, 
scientific, quality-control and data-acquisition 
implementations. User dialogs and popup menus, 
graph plus table, revolving subsets / panning 
points, smooth real-time, no overlapping labels, 
help, maximization, extensive export capabilities, 
comprehensive hot-spots, zooming, null-data, and 
quick / easy to implement. You must see to 
appreciate. Call for a free demo or down load 
"pedemo.zip" from CIS’s MSBASIC forum. 

Take a ^ 

Gigasoft, Inc. 817-431-8470 fax:817-431-9860 



Satisfaction 

Guaranteed! 
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UNDERSTAND the most 

WANTED GRAPHICS TECHNIQUES 

’ Contains all you need to 
understand morphing, 
animation, image 
processing, file format 
translation, fractals, color 
manipulation and more! 

* CD-ROM with all source 
code, image files and 
hypertext book. 

Author: Control Zed. ISBN 1-874416-31-1 $44.95 



TO ORDER 

Tel. 800 937 5557 
Fax. 800 PRI ORDER 


WROX 

QUOTE CODE CL11 FOR FREE FREIGHT 


For more information or a free catalog of 
Wrox Press programming titles call 800 814 4527 

WORLD CLASS PROGRAMMING TITLES 
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Porting Borland DOS BGI 
Graphics Code To Windows? 

If so, we’ve got just the toolkit for you! BGI For 
Windows ($129.95) provides an interface to 
the Windows 3.x graphics engine that is fully 
compatible with calls to the DOS based 
Borland BGI graphics library, and provides 
extensions to support 24 bit color, high 
resolution Windows displays, TrueType fonts, 
and complete hardcopy. Full source and a 
royalty-free object code and DLL distribution 
license is included. BGI For Windows 
supports Borland C/C++ and Pascal language 
compilers that can build Windows apps. 

Ryle Design is a leading developer of tools to 
complement the Borland BGI graphics library. 
In addition to BGI For Windows we have 
comprehensive DOS BGI drivers for SVGA 
video and high resolution printer support, and 
tools to enhance BGI fonts. All toolkits come 
with full source and royalty-free distribution 
licenses. VISA/MC/AMEX. Call, write, or fax 
for our latest catalog! 

Ryle Design 

PO Box 22, Mt. Pleasant Ml 48804 USA 
Voice/Fax: 517.773.0587 
73047.1765@compuserve.com 


□ Request Reader Service #137 □ 


Developer Jobs! 

Internet: das@scientific.com 

Commercial software developers should reg¬ 
ister with Scientific Placement. R&Djobs for 
software engineers, SQA, product managers, 
etc. Nationwide contacts with both large and 
small companies including start-ups. Many 
clients develop and publish commercial soft¬ 
ware products. Most develop for Windows, 
NT, Macintosh, OS/2, and Unix based plat¬ 
forms. We also recruit in other leading edge 
technology areas such as PDA, low level and 
real-time, compilers, etc. Managed by gradu¬ 
ate engineers. Send resume or call to get an 
assessment of your marketability. Never a fee. 

Scientific Placement, Inc. 
1-800-231-5920 


CompuServe: 71250,3001, AOL: davesmall 
CJ, Box 19949, Houston, TX 77224 
713-496-6100 Fax:713-496-0373 
CJ, Box 71, San Ramon, CA 94583 
510-733-6168 Fax 510-733-6057 
Beth@spica.bdt.com 
CJ, Box 4270, Johnson City. TN 37602 
615-854-9444 Fax 615-854-9454 rjg@spi.rabbit.net 
CJ, Kenmore Station, Box 15225, Boston, MA 02215 
617-424-8372 Fax: 617-424-7158 jen@spbos.pn.com 
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"Add support for 36 raster file formats instantly!" New 

AccuSoft Image Format Library 

Import - Export - Scanning - Conversion - Compression 
Printing - Display - Image Processing - Special Effects Version 



AccuSoft has clone it again! You asked for more formats: we 
added 24 new formats. You asked for more speed: we made it 
faster. You wanted advanced color reduction: we added a superb 
new color reduction technology. You wanted thumbnails: we 
added them. You asked for it, you got it-. Version 5! 

Guaranteed to read all raster images in 36 formats! We have 
offered this guarantee for nearly 3 years. This guarantee means 
you and your customers get the highest quality imaging technology 
available. 

Incredibly easy to use interface that simplifies development! A 
single function call provides support for all 36 formats with 
autodetect. Simply pass the filename to our library! And if you 
want complete control, we give you that also. 

Al standard image compression techniques are supported 
including Group III, Group IV, JPEG, LZW, Huffman, Packbits, and 
Runlength. You can even create your own file format with Version 
5 using the built-in compression. 

Functions provided include rotate, invert, zoom, pan, scroll, resize, 
crop, sharpen, contrast, brightness, color reduction, gamma control, 
palette control, multi-page display, matrix convolutions, 
thumbnails, and much more. 

Performance is of the utmost importance to our customers and we 
continually push the envelope to achieve faster image loading, 
display, processing and compression. Version 5 is the best 
performer yet! 

We are now the acknowledged leader in imaging toolkits, and 
Version 5 is the next step in the evolution of high performance 
imaging! Call now to order or to get more information about our 
complete line of imaging toolkits. 



New 5.0 features: 

& Faster image loading & processing 
«3t/ All new, advanced color reduction 
New levels of flexibility 
^ Create your own format 
ft New compression algorithms 
ft Display while decompressing 
ft Status/cancel for all functions 
ft" 24 new raster formats supported 
ft Automatic thumbnails of any size 
S New scanning features 
ft I/O replacement for total control 
ft Plus many more new features 

iVew Formats'. 

Now Supporting 

Photo CD 


Pro Gold versions 


All the features of standard toolkits PLUS: 


Fastest imaging toolkit available 
Lightning fast Group IV support 
Fastest JfPEG available at any price 
Superb quality scale-to-gray display 
One hundredth of degree rotation 
Cornerstone ImageAccel supported 
Read any image sub-region 
Multi-page, high speed scanning 



All Platforms Supported! 




Guaranteed to read all raster 
images in existence in the 
supported formats. If you can 
find a valid image we don’t 
read, send it to us and we will 
make it work. 


(800) 525-3577 

(508) 898-2770 
(508) 898-9662 FAX 




High Performance Imaging 

Copyright 1994 AccuSoft Corporation. All rights reserved. AccuSoft Corporation 112 Turnpike Rd. RO. Box 1261 Westborough, MA 01581 
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Give Your Bugs The Bird! 

Get The Combined Power of A Heap Checker, Spy Utility, Debug 
Kernel, API Debugger And GPF Tool, All In A Single Package. 


N eed the perfect bug finding 
tool? Nu-Mega has it! — in 
Windows, DOS, WindowsNT, WIN32S 
even Windows 95. It's called BOUNDS 
CHECKER™. Many say it's the most ver¬ 
satile and powerful automatic bug find¬ 
ing tool money can buy. Our customers 
love it because it saves them huge 
amounts of time and does "clean-up" bet¬ 
ter than anything out there. 

Where Do Bugs Come from? 

Today's bugs are just as likely to come 
from improperly interfacing with the oper¬ 
ating system or third party components as 
with your programming language. That's 
why we've expanded BOUNDS- 
CHECKER into a single comprehensive 
tool that points it's long bug hunting fin¬ 
ger at the types of problems you are most 
likely to encounter. 

Stop Problems like: 

■ API Parameter Errors ■ Memory And 
Resource Leakage ■ Data And Heap 
Corruption ■ API Compliance Errors ■ 
Processor Faults ■ C/C++ Pointer Errors 
■ API Return Value Errors ■ VBX Interface 
errors and more! 

Find Out Why They Happen 

Your work is not always done when the 
bug is found. In fact, 50% of the job is 
finding out what caused the bug. There's 
great news though — BOUNDSCHECKER 
works as your partner in helping you 
diagnose the problem. Along with giving 
you the description of the bug, 
BOUNDS-CHECKER reveals the source 
line that most likely caused the bug! For 
more difficult problems, you can access 
a variety of windows and inspectors that 
show you the state-of-the-program at the 
instant the bug was found! And for "killer 
bugs", BOUNDS-CHECKER shows you 
the history of events that led up to the 
problem! What's more, with BOUNDS- 
CHECKER, you can go back in time and 
observe the series of Windows mes¬ 


sages, APIs and other events that preceded 
the bug. This is the power you've been 
waiting for — now turn week-long debug 
sessions into a few minutes work! 

New In BOUNDS-CHECKER! 

VBX and Windows 95 support— 
BOUNDS-CHECKER now validates the 
VBX custom control interface and logs VBX 



events as part of its trace history. Whether 
your program is written in VB, C/C++ or 
any other language, you can get a handle 
on some of the weirdest bugs you are like¬ 
ly to hit. 

TView™ - Cool Event Viewer! 

As your program runs, BOUNDS-CHECKER 
transparently logs messages, API calls, 
hooks, callbacks, VBX calls and many other 
events in a trace file. TView, BOUNDS- 
CHECKER's event viewer graphically orga¬ 
nizes and filters events so that you can see 
a high-level view of your program's run-time 
activity. When you want to see more 
detail, just click on events of interest to 


expand, level-by-level! You can also view 
API parameters and even bring up the 
source line associated with an event. 
Besides helping you see programs from 
the inside,(even on executables with no 
debug information), TView is an excellent 
tool for tracking down some of the tough¬ 
est Windows problems. 


The Perfect Q/A Tool 

If your job includes making sure your com¬ 
pany's programs are as solid as possible, 
you need the power of BOUNDS- 
CHECKER. Many of the bugs that 
BOUNDS-CHECKER finds will be invisi¬ 
ble during test cases, but this tool has 
eyes! You cannot possibly test every per¬ 
mutation on every conceivable system 
configuration —but, by using BOUNDS- 
CHECKER, you can flush-out the hidden 
bugs and greatly improve your quality. 


Don’t Doubt It, Do It! 

Next time, show your bugs who's 
boss. Give'em the bird! ©s 

“ e 

I- . -1 

Order A Trio And Save A Bundle! 

Choose any two BOUNDSCHECKER 
products and get the third FREE! 

BOUNDS-CHECKER 
O For Windows □ For 32/NT 
□ For WIN32S □ For DOS 

O Windows 95 Pre-Release Program 

(Call for ordering information) 


Special Trio Price: $498! SAVE $249! 
Call Nu-Mega Now! (603) 889-2386 
Or Fax This Form! (603) 889-1135 


□ VISA □ MasterCard □ American Express 

Card #____Exp._ 

Card Holder Name (Print)_ 

Signature_ 

Phone:__ 

OverNight Delivery! Shipping/Handling Add $7.00 ] 


BOUNDS-CHECKER, SOFT-ICE, AND NU-MEGA TECHNOLOGIES are trademarks owned by Nu-Mega Technologies, Inc. All other trademarks are owned by their respective owners. 


CALL: 1-800-4-NU-MEGA (1-800-468-6342) 
Orders Only 

FAX: (603)889-1135 

□ 
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} TECHNOLOGIES INC 
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30 DAY 

MONEY BACK GUARANTEE 


Nashua, NH 03060-7780 U.S.A. 
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603-595-0386 
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